Spec-Zone.ru › Symfony 4.1

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API