Описание функции wp_delete_file()
Функция wp_delete_file() предназначена для удаления файлов из файловой системы WordPress. Она используется, когда необходимо удалить временные файлы, загруженные пользователями, или файлы, которые больше не нужны. Функция безопасно обрабатывает удаление, проверяя наличие файла перед его удалением и возвращая соответствующий результат.
Функция появилась в версии 2.5.0 и находится в файле wp-includes/functions.php
Параметры
$file
Тип: string
Обязательный: Да
Описание: Путь к файлу, который необходимо удалить
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном удалении файла, иначе false
Возможные значения:
• true — файл успешно удален
• false — файл не найден или не удалось удалить
Примеры использования
Базовый пример удаления файла
$result = wp_delete_file('/path/to/your/file.txt');
// Проверка результата
if ($result) {
echo 'Файл успешно удален';
} else {
echo 'Не удалось удалить файл';
}
Файл будет удален, если он существует
Удаление временного файла, если он существует
$temp_file = '/path/to/temp/file.tmp';
if (file_exists($temp_file)) {
wp_delete_file($temp_file);
}
Проверка существования файла перед удалением
Пример обработки ошибки при удалении файла
$file_to_delete = '/path/to/nonexistent/file.txt';
$result = wp_delete_file($file_to_delete);
if (!$result) {
error_log('Ошибка: файл не найден или не удалось удалить');
}
Логирование ошибки в файл журнала
Безопасность
Валидация входных данных: Функция ожидает строковый параметр с путем к файлу
Санитизация: Путь к файлу должен быть проверен на безопасность перед вызовом
Рекомендации: Убедитесь, что пользователь имеет права на удаление файла
— Связанные функции
Проверяет, существует ли файл
Удаляет файл, аналогично wp_delete_file()
— Примечания
– Ограничения
Не удаляет директории, только файлы
– Частые проблемы
- Ошибка при удалении из-за отсутствия прав
- Файл не найден по указанному пути
