league / mime-type-detection
Mime-type detection for Flysystem
Fund package maintenance!
frankdejonge
Tidelift
Installs: 148 576 145
Dependents: 56
Suggesters: 1
Security: 0
Stars: 1 056
Watchers: 7
Forks: 12
Open Issues: 5
Requires
- php: ^7.2 || ^8.0
- ext-fileinfo: *
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.2
- phpstan/phpstan: ^0.12.68
- phpunit/phpunit: ^8.5.8 || ^9.3
README
This package supplies a generic mime-type detection interface with a
finfo
based implementation.
Usage
composer require league/mime-type-detection
Detectors
Finfo with extension fallback:
$detector = new League\MimeTypeDetection\FinfoMimeTypeDetector(); // Detect by contents, fall back to detection by extension. $mimeType = $detector->detectMimeType('some/path.php', 'string contents'); // Detect by contents only, no extension fallback. $mimeType = $detector->detectMimeTypeFromBuffer('string contents'); // Detect by actual file, no extension fallback. $mimeType = $detector->detectMimeTypeFromFile('existing/path.php'); // Only detect by extension $mimeType = $detector->detectMimeTypeFromPath('any/path.php'); // Constructor options $detector = new League\MimeTypeDetection\FinfoMimeTypeDetector( $pathToMimeDatabase, // Custom mime database location, default: '' $customExtensionMap, // Custom extension fallback mapp, default: null $bufferSampleSize // Buffer size limit, used to take a sample (substr) from the input buffer to reduce memory consumption. );
Extension only:
$detector = new League\MimeTypeDetection\ExtensionMimeTypeDetector(); // Only detect by extension $mimeType = $detector->detectMimeType('some/path.php', 'string contents'); // Always returns null $mimeType = $detector->detectMimeTypeFromBuffer('string contents'); // Only detect by extension $mimeType = $detector->detectMimeTypeFromFile('existing/path.php'); // Only detect by extension $mimeType = $detector->detectMimeTypeFromPath('any/path.php');
Extension mime-type lookup
As a fallback for finfo
based lookup, an extension map
is used to determine the mime-type. There is an advised implementation
shipped, which is generated from information collected by the npm
package mime-db.
Provided extension maps
Generated:
$map = new League\MimeTypeDetection\GeneratedExtensionToMimeTypeMap(); // string mime-type or NULL $mimeType = $map->lookupMimeType('png');
Overriding decorator
$innerMap = new League\MimeTypeDetection\GeneratedExtensionToMimeTypeMap(); $map = new League\MimeTypeDetection\OverridingExtensionToMimeTypeMap($innerMap, ['png' => 'custom/mimetype']); // string "custom/mimetype" $mimeType = $map->lookupMimeType('png');
Empty:
$map = new League\MimeTypeDetection\EmptyExtensionToMimeTypeMap(); // Always returns NULL $mimeType = $map->lookupMimeType('png');