wwaz/mimetype-php

Determines mimetype of a filepath (string) or file resource

1.1.0 2025-02-12 17:55 UTC

Requires

• ralouphie/mimey: ^1.0

Requires (Dev)

• phpunit/phpunit: ^11

MIT

• WWAZ

README

Zero-config MIME type detection for PHP – automatically via file extension or content type.

Quick Start

composer require wwaz/mimetype

use wwaz\Mimetype\Mimetype;

echo Mimetype::get('document.pdf');  // → application/pdf

get() first tries detection by file extension. If that fails (missing extension or unknown type), it automatically falls back to content-type analysis – no configuration needed.

API

Mimetype::get(string $filename): string|false

Universal method – the right choice for most cases.

Mimetype::get('image.png');           // → image/png
Mimetype::get('/var/upload/avatar');  // → image/jpeg  (via content type)
Mimetype::get('archive.tar.gz');      // → application/gzip

Mimetype::fromPath(string $filename): string|false

Detection by file extension only. Throws MimetypeException if the extension is missing.

Mimetype::fromContentType(string $filename): string|false

Detection by PHP mime_content_type() only. The file must exist on the filesystem.

Examples

1 – Validate a file upload

$mime = Mimetype::get($_FILES['upload']['tmp_name']);

$allowed = ['image/jpeg', 'image/png', 'image/webp'];

if (!in_array($mime, $allowed)) {
    throw new RuntimeException('Only JPEG, PNG and WebP are allowed.');
}

2 – Set the Content-Type header

$file = '/var/www/assets/logo.svg';
header('Content-Type: ' . Mimetype::get($file));
readfile($file);

3 – Handle a missing extension gracefully

use wwaz\Mimetype\Exceptions\MimetypeException;

try {
    $mime = Mimetype::fromPath('mysterious-file');
} catch (MimetypeException $e) {
    // Fall back to content-type detection
    $mime = Mimetype::fromContentType('/path/to/mysterious-file');
}

Dependencies

Package	Purpose
ralouphie/mimey	Extensible MIME type database
PHP ≥ 8.0	`string

MIT © wwaz