vigstudio/ mimey
PHP包,用于将文件扩展名转换为MIME类型,反之亦然。
2.2.0
2021-02-05 09:08 UTC
Requires
- php: ^5.4|^7.0|^8.0
Requires (Dev)
- php-coveralls/php-coveralls: ^1.1
- phpunit/phpunit: ^4.8 || ^5.7 || ^6.5
README
PHP包,用于将文件扩展名转换为MIME类型,反之亦然。
此包使用httpd的mime.types文件生成文件扩展名到MIME类型的映射,反之亦然。
该mime.types
文件由bin/generate.php
解析,并转换为在mime.types.php
中的优化PHP数组,然后由辅助类\Mimey\MimeTypes
包装。
使用方法
$mimes = new \Mimey\MimeTypes; // Convert extension to MIME type: $mimes->getMimeType('json'); // application/json // Convert MIME type to extension: $mimes->getExtension('application/json'); // json
获取所有
虽然很少见,但某些扩展名对应多个MIME类型
// Get all MIME types for an extension: $mimes->getAllMimeTypes('wmz'); // array('application/x-ms-wmz', 'application/x-msmetafile')
然而,许多MIME类型对应多个扩展名
// Get all extensions for a MIME type: $mimes->getAllExtensions('image/jpeg'); // array('jpeg', 'jpg', 'jpe')
自定义转换
您可以通过更改传递给MimeTypes
的映射来添加自定义转换。
有一个MimeMappingBuilder
可以帮助您完成此操作
// Create a builder using the built-in conversions as the basis. $builder = \Mimey\MimeMappingBuilder::create(); // Add a conversion. This conversion will take precedence over existing ones. $builder->add('custom/mime-type', 'myextension'); $mimes = new \Mimey\MimeTypes($builder->getMapping()); $mimes->getMimeType('myextension'); // custom/mime-type $mimes->getExtension('custom/mime-type'); // myextension
您可以将任何数量的转换添加到构建器中
$builder->add('custom/mime-type', 'myextension'); $builder->add('foo/bar', 'foobar'); $builder->add('foo/bar', 'fbar'); $builder->add('baz/qux', 'qux'); $builder->add('cat/qux', 'qux'); ...
优化自定义转换加载
您可以通过将所有转换保存为构建步骤的一部分的编译PHP文件来优化自定义转换的加载。
// Add a bunch of custom conversions. $builder->add(...); $builder->add(...); $builder->add(...); ... // Save the conversions to a cached file. $builder->save($cache_file_path);
然后可以加载该文件以避免重复调用$builder->add(...)
的开销
// Load the conversions from a cached file. $builder = \Mimey\MimeMappingBuilder::load($cache_file_path); $mimes = new \Mimey\MimeTypes($builder->getMapping());
安装
与PHP >= 5.4兼容。
composer require ralouphie/mimey