Merge pull request #34 from JosephGabito/joseph/mime-type-matching

Author: JasonTheAdams

src/Files/ValueObjects/MimeType.php

@@ -169,6 +169,22 @@ public static function isValid(string $mimeType): bool
         );
     }
 
+    /**
+     * Checks if this MIME type is a specific type.
+     *
+     * This method returns true when the stored MIME type begins with the
+     * given prefix. For example, `"audio"` matches `"audio/mpeg"`.
+     *
+     * @since n.e.x.t
+     *
+     * @param string $mimeType The MIME type prefix to check (e.g., "audio", "image").
+     * @return bool True if this MIME type is of the specified type.
+     */
+    public function isType(string $mimeType): bool
+    {
+        return strpos($this->value, strtolower($mimeType) . '/') === 0;
+    }
+
     /**
      * Checks if this is an image MIME type.
      *
@@ -178,7 +194,7 @@ public static function isValid(string $mimeType): bool
      */
     public function isImage(): bool
     {
-        return strpos($this->value, 'image/') === 0;
+        return $this->isType('image');
     }
 
     /**
@@ -190,7 +206,7 @@ public function isImage(): bool
      */
     public function isAudio(): bool
     {
-        return strpos($this->value, 'audio/') === 0;
+        return $this->isType('audio');
     }
 
     /**
@@ -202,7 +218,7 @@ public function isAudio(): bool
      */
     public function isVideo(): bool
     {
-        return strpos($this->value, 'video/') === 0;
+        return $this->isType('video');
     }
 
     /**
@@ -214,7 +230,7 @@ public function isVideo(): bool
      */
     public function isText(): bool
     {
-        return strpos($this->value, 'text/') === 0;
+        return $this->isType('text');
     }
 
     /**

tests/unit/Files/ValueObjects/MimeTypeTest.php

@@ -282,4 +282,22 @@ public function testNormalizesValues(): void
         $mimeType = new MimeType('IMAGE/JPEG');
         $this->assertEquals('image/jpeg', (string) $mimeType);
     }
+
+    public function testIsType(): void
+    {
+        $imageType = new MimeType('image/jpeg');
+        $fontType = new MimeType('font/ttf');
+        
+        $this->assertTrue($imageType->isType('image'));
+        $this->assertFalse($imageType->isType('video'));
+
+        $this->assertTrue($fontType->isType('font'));
+        $this->assertFalse($fontType->isType('image'));
+
+        // Case insensitive.
+        $this->assertTrue($fontType->isType('Font'));
+        $this->assertTrue($fontType->isType('FONT'));
+        $this->assertTrue($imageType->isType('image'));
+        $this->assertTrue($imageType->isType('IMAGE'));
+    }
 }