Описание функции sanitize_file_name()
Функция sanitize_file_name() очищает имя файла, удаляя недопустимые символы и заменяя пробелы на подчеркивания. Эта функция используется при загрузке файлов через медиа-библиотеку и другие механизмы загрузки файлов в WordPress.
Она обеспечивает безопасность и совместимость имен файлов с файловой системой
Параметры
$filename
Тип: string
Обязательный: Да
Описание: Имя файла для очистки
Возможные значения:
Возвращаемое значение
Тип: string
Описание: Очищенное имя файла
Возможные значения:
• Имя файла без недопустимых символов
• Пустая строка, если входное имя файла было недопустимым
Примеры использования
Базовый пример очистки имени файла
$clean_filename = sanitize_file_name('my file @name!.jpg');
// Результат: my_file_name.jpg
Недопустимые символы удалены
Очистка имени файла с пробелами
$clean_filename = sanitize_file_name('my document.docx');
// Результат: my_document.docx
Пробелы заменены на подчеркивания
Безопасность
Валидация входных данных: Функция проверяет входные данные и удаляет недопустимые символы
Санитизация: Имя файла автоматически очищается от недопустимых символов
Рекомендации: Используйте sanitize_file_name() перед загрузкой файлов, чтобы избежать проблем с файловой системой
— Связанные функции
Обрабатывает загрузку файла и использует sanitize_file_name() для очистки имени
Очистка заголовка для создания слага
— Примечания
– Ограничения
Не очищает имя файла, если оно уже безопасно
– Частые проблемы
- Имя файла может быть пустым, если все символы недопустимы
- Некоторые символы могут быть преобразованы в недопустимые
