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'));
Свойства
| protected array | $guessers | Все зарегистрированные экземпляры MimeTypeGuesserInterface. |
Методы
| 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.
https://api.symfony.com/4.1/Symfony/Component/HttpFoundation/File/MimeType/MimeTypeGuesser.html