Accurate MIME Type Detection in PHP with league/mime-type-detection

When building a file‑handling system, correctly detecting a file's MIME type is crucial, but PHP's built‑in functions can be unreliable; the author therefore adopted the league/mime-type-detection library for a more dependable solution.

Installation and Usage

The library can be installed easily with Composer:

composer require league/mime-type-detection

The package provides a generic MIME‑type detection interface built on finfo , supporting detection by file content as well as by file extension.

Detection based on finfo

use League\MimeTypeDetection\FinfoMimeTypeDetector;

$detector = new FinfoMimeTypeDetector();

// Detect MIME type using both file content and extension
$mimeType = $detector->detectMimeType('some/path.php', 'string contents');

// Detect MIME type from raw content only
$mimeType = $detector->detectMimeTypeFromBuffer('string contents');

// Detect MIME type from an existing file
$mimeType = $detector->detectMimeTypeFromFile('existing/path.php');

// Detect MIME type using only the file path (extension)
$mimeType = $detector->detectMimeTypeFromPath('any/path.php');

Detection based on extension only

use League\MimeTypeDetection\ExtensionMimeTypeDetector;

$detector = new ExtensionMimeTypeDetector();

// Detect MIME type using only the file extension
$mimeType = $detector->detectMimeType('some/path.php', 'string contents');

Lookup extensions from MIME type

Since version 1.13.0 the library also allows looking up extensions that correspond to a given MIME type:

// Find a single extension for a MIME type
$extension = $detector->lookupExtension($mimeType);

// Find all possible extensions for a MIME type
$allExtensions = $detector->lookupAllExtensions($mimeType);

Mapping extensions to MIME types

The package includes a generated map that can translate file extensions back to MIME types, complementing finfo detection:

use League\MimeTypeDetection\GeneratedExtensionToMimeTypeMap;

$map = new GeneratedExtensionToMimeTypeMap();
$mimeType = $map->lookupMimeType('png');

Advantages and Effects

After integrating league/mime-type-detection , the author's file‑handling system became more stable and accurate, offering flexible and efficient detection via both content and extensions. Composer management also simplified dependency handling.

Overall, the library solved the project's MIME‑type detection issues, improved performance, and enhanced user experience, making it a strong recommendation for anyone facing similar challenges.

Long‑press the QR code to learn Composer