Описание функции wp_delete_file_from_directory()
Функция wp_delete_file_from_directory() удаляет указанный файл из указанной директории. Она полезна для управления файлами, например, при удалении временных файлов или при очистке загруженных файлов. Функция проверяет, существует ли файл, и удаляет его, если это возможно.
Если файл не существует или не может быть удален, функция возвращает false.
Параметры
$file
Тип: string
Обязательный: Да
Описание: Полный путь к файлу, который необходимо удалить.
Возможные значения:
$dir
Тип: string
Обязательный: Да
Описание: Директория, в которой находится файл.
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном удалении файла, false в противном случае.
Возможные значения:
• true — файл успешно удален
• false — файл не найден или не может быть удален
Примеры использования
Базовый пример удаления файла из директории
$result = wp_delete_file_from_directory('/var/www/html/wp-content/uploads/image.jpg', '/var/www/html/wp-content/uploads/');
// Проверяем результат
if ($result) {
echo 'Файл успешно удален';
} else {
echo 'Ошибка при удалении файла';
}
Файл image.jpg будет удален из папки uploads
Пример обработки ошибки при попытке удалить несуществующий файл
$file = '/var/www/html/wp-content/uploads/nonexistent.jpg';
$result = wp_delete_file_from_directory($file, '/var/www/html/wp-content/uploads/');
if ($result) {
echo 'Файл успешно удален';
} else {
echo 'Файл не найден или не может быть удален';
}
Сообщение об ошибке будет выведено
Безопасность
Валидация входных данных: Функция не производит глубокой валидации путей, важно проверять вводимые данные перед вызовом.
Санитизация: Параметры должны быть обработаны перед использованием.
Рекомендации: Используйте wp_normalize_path() для нормализации путей перед удалением
— Связанные функции
PHP функция для удаления файлов.
Проверяет существование файла.
— Примечания
– Ограничения
Работает только с файлами, доступными для удаления в текущей файловой системе.
– Частые проблемы
- Ошибка при недостатке разрешений на удаление файла
- Неправильный путь к файлу или директории
