awaisjameel/mimetypes

A Laravel package for dynamically fetching, caching, and resolving MIME types and file extensions using the latest Apache MIME types list. Perfect for file upload validation and content-type detection.

1.0.0 2025-02-03 19:01 UTC

Requires

• php: >=7.4
• illuminate/contracts: ^8.0||^9.0||^10.0||^11.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.9
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^9.0.0||^8.22.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/extension-installer: ^1.3
• phpstan/phpstan-deprecation-rules: ^1.1
• phpstan/phpstan-phpunit: ^1.3
• spatie/laravel-ray: ^1.35

MIT

• Awais Jameel

• laravel
• mimetypes
• AwaisJameel
• mimetype-to-extension
• extension-to-mimetype

README

MimeTypes is a Laravel package designed to dynamically fetch, cache, and resolve MIME types and file extensions. It retrieves the latest MIME type mappings from the official Apache MIME types repository and provides an easy-to-use API for resolving MIME types from file extensions and vice versa.

With built-in caching support and seamless integration into Laravel's ecosystem, this package ensures optimal performance and up-to-date data for handling file types.

Features

• Dynamic MIME Type Fetching: Automatically fetch the latest MIME types from Apache's repository.
• Bi-Directional Resolution: Resolve MIME types to extensions and extensions to MIME types.
• Caching for Performance: Cache MIME type mappings for a configurable duration (default: 24 hours).
• Laravel Integration: Fully compatible with Laravel, using its caching and HTTP systems.
• Customizable TTL: Configure cache expiration to suit your application's requirements.
• Robust Error Handling: Clear and descriptive exceptions for invalid inputs or network issues.

Use Cases

• File Upload Validation : Ensure files match the expected MIME type or extension before processing.
• Content-Type Detection : Dynamically determine the appropriate MIME type for file downloads or API responses.
• Dynamic File Handling : Manage and validate file operations based on the latest MIME standards.

Why Use MimeTypes?

Dealing with MIME types can be cumbersome when relying on outdated static mappings or manually maintaining lists. MimeTypes automates the process, giving you:

• Up-to-date MIME mappings.
• Improved performance with caching.
• Simplicity with a Laravel-tailored API.

Whether you're working on file upload systems, API responses, or content-type validation, this package provides a reliable and efficient solution for managing MIME types.

Installation

You can install the package via composer:

composer require awaisjameel/mimetypes

You can publish the config file with:

php artisan vendor:publish --tag="mimetypes-config"

This is the contents of the published config file:

return [
    'mime_types_ttl' => 1440, // Default cache duration in minutes
];

Usage

use AwaisJameel\MimeTypes\MimeTypes;

//get Extension from Mime Type
try {
    $extension = MimeTypes::getExtensionOrMime('text/html');
    echo $extension; // Output: html
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}

//get Mime Type from Extension
try {
    $mimeType = MimeTypesService::getExtensionOrMime('jpg');
    echo $mimeType; // Output: image/jpeg
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}

//If the provided MIME type or extension is invalid, the package will throw an exception:
try {
    $result = MimeTypesService::getExtensionOrMime('invalid/mime');
} catch (Exception $e) {
    echo "Error: " . $e->getMessage(); // Output: Invalid MIME type or extension!
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Security Vulnerabilities

Credits

• Awais Jameel
• All Contributors

License

The MIT License (MIT). Please see License File for more information.