MimeTypeGuesser
class MimeTypeGuesser implements MimeTypeGuesserInterface
Одиночный угадатель типа MIME.
По умолчанию все угадатели типов MIME, предоставляемые фреймворком, устанавливаются (если они доступны в текущей ОС/настройках PHP).
Вы можете зарегистрировать пользовательских угадателей, вызвав метод register() на экземпляре одиночки. Пользовательские угадатели всегда вызываются перед стандартными.
$guesser = MimeTypeGuesser::getInstance();
$guesser->register(new MyCustomMimeTypeGuesser());
Если вы хотите изменить порядок стандартных угадателей, просто повторно зарегистрируйте нужный вам как пользовательский. Последний зарегистрированный угадатель имеет приоритет перед ранее зарегистрированными.
Перерегистрация встроенного угадателя также позволяет его настроить:
$guesser = MimeTypeGuesser::getInstance();
$guesser->register(new FileinfoMimeTypeGuesser('/path/to/magic/file'));
Методы
| static MimeTypeGuesser | getInstance() Возвращает экземпляр одиночки. | |
| static | reset() Сбрасывает экземпляр одиночки. | |
| register(MimeTypeGuesserInterface $guesser) Регистрирует новый угадатель типа MIME. | ||
| string | guess(string $path) Пытается угадать тип MIME заданного файла. |
Подробности
static MimeTypeGuesser getInstance()
Возвращает экземпляр одиночки.
Возвращаемое значение
| MimeTypeGuesser |
static reset()
Сбрасывает экземпляр одиночки.
register(MimeTypeGuesserInterface $guesser)
Регистрирует новый угадатель типа MIME.
При угадывании этот угадатель имеет приоритет над ранее зарегистрированными.
Параметры
| MimeTypeGuesserInterface | $guesser |
string guess(string $path)
Пытается угадать тип MIME заданного файла.
Файл передается каждому зарегистрированному угадателю типа MIME в обратном порядке их регистрации (последний зарегистрированный запрашивается в первую очередь). Как только угадатель возвращает значение, отличное от NULL, этот метод завершается и возвращает значение.
Параметры
| string | $path | Путь к файлу |
Возвращаемое значение
| string | Тип MIME или NULL, если тип не удалось угадать |
Исключения
| LogicException | |
| FileNotFoundException | |
| AccessDeniedException |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/HttpFoundation/File/MimeType/MimeTypeGuesser.html