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, если тип MIME не удалось угадать |
Исключения
| LogicException | |
| FileNotFoundException | |
| AccessDeniedException |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/HttpFoundation/File/MimeType/MimeTypeGuesser.html