# Функция SANITIZE_MIME_TYPE() в WordPress
Функция sanitize_mime_type()
предназначена для очистки типа MIME. Это важно для обеспечения безопасности и правильной работы с файлами в WordPress.
## Как работает функция?
Функция очищает входные данные, чтобы тип MIME соответствовал стандартам и не содержал недопустимых символов. Это особенно полезно при загрузке файлов, чтобы избежать проблем с безопасностью.
**Время выполнения:**
- 1 раз — 0.000049 секунды (очень быстро)
- 50000 раз — 0.04 секунды (практически мгновенно)
## Хуки функции
Функция использует хук sanitize_mime_type
, который позволяет другим разработчикам изменять очищенный тип MIME перед его возвратом.
## Возвращаемое значение
Функция возвращает строку — очищенный тип MIME.
## Использование функции
Чтобы использовать функцию, напишите следующий код:
$clean_mime = sanitize_mime_type( 'audio/vnd.wave' );
echo $clean_mime; // Вывод: audio/vnd.wave
### Аргументы функции
- **$mime_type (строка)** — обязательный параметр, который указывает тип MIME, который нужно очистить.
## Примеры использования
### Пример 1: Очистка типа MIME
```php
$mine = sanitize_mime_type( 'audio / vnd.wave' );
echo $mine; // Вывод: audio/vnd.wave
$mimetype = sanitize_mime_type( 'typeexample1-_/[]{}.pdf' );
echo $mimetype; // Вывод: typeexample1-/.pdf
Пример 2: Список стандартных типов MIME
Вот некоторые распространённые типы MIME:
Тип | Описание |
---|---|
application/json | Формат JSON для объектов JavaScript |
application/pdf | Формат PDF для документов |
image/jpeg | Формат JPEG для изображений |
audio/mp3 | Формат MP3 для аудиофайлов |
video/mp4 | Формат MP4 для видеороликов |
Чтобы получить полный список типов MIME, их можно найти в документации, но здесь приведены наиболее распространённые.
Лог изменений
- Версия: 3.1.3 — функция была введена.
Код функции
Вот как выглядит код функции sanitize_mime_type
:
function sanitize_mime_type( $mime_type ) {
$sani_mime_type = preg_replace( '/[^-+*.a-zA-Z0-9/]/', '', $mime_type );
/**
- Фильтрует тип MIME после очистки.
- @param string $sani_mime_type Очищенный тип MIME.
- @param string $mime_type Тип MIME до очистки.
*/
return apply_filters( 'sanitize_mime_type', $sani_mime_type, $mime_type );
}
Связанные функции
Существуют и другие функции для очистки различных типов данных в WordPress, например:
sanitize_email()
— для очистки адреса электронной почты.sanitize_file_name()
— для очистки имени файла.sanitize_text_field()
— для очистки текстового поля.