wp_delete_file_from_directory() │ WP 4.9.7

Удаляет указанный файл из указанной папки, только если файл находится в этой папке.

Что делает функция:

  1. Переводит указанные пути (до файла и папки) из относительных в реальные realpath().
  2. Проверяет по полученным путям, находится ли указанный файл в указанной папке.
  3. Вызывает wp_delete_file( $file )

Можно указать файл который находится во вложенной папке, проверка будет пройдена. Например:

$file      = 'www/wp-content/uploads/2019/03/image.jpg';
$directory = 'www/wp-content/uploads/';
Работает на основе: wp_delete_file()
Основа для: wp_delete_attachment_files()

Хуков нет.

Возвращает

true|false. True в случае успеха, false в случае неудачи.

Использование

wp_delete_file_from_directory( $file, $directory );
$file(строка) (обязательный)
Абсолютный путь к удаляемому файлу.
$directory(строка) (обязательный)
Абсолютный путь к каталогу (папке).

Примеры

0

#1 Удалим файл test.html из каталога загрузок uploads 

$upldir_info = wp_get_upload_dir();
$uploads_dir = $upldir_info['basedir']; // uploads path

wp_delete_file_from_directory( "$uploads_dir/test.html", $uploads_dir ); // true или false

Список изменений

С версии 4.9.7 Введена.

Код wp_delete_file_from_directory() WP 6.3.1

wp-includes/functions.php 
function wp_delete_file_from_directory( $file, $directory ) {
	if ( wp_is_stream( $file ) ) {
		$real_file      = $file;
		$real_directory = $directory;
	} else {
		$real_file      = realpath( wp_normalize_path( $file ) );
		$real_directory = realpath( wp_normalize_path( $directory ) );
	}

	if ( false !== $real_file ) {
		$real_file = wp_normalize_path( $real_file );
	}

	if ( false !== $real_directory ) {
		$real_directory = wp_normalize_path( $real_directory );
	}

	if ( false === $real_file || false === $real_directory || ! str_starts_with( $real_file, trailingslashit( $real_directory ) ) ) {
		return false;
	}

	wp_delete_file( $file );

	return true;
}

Файловая система (files dirs folders создание удаление директорий файлов)

Файловая система (WP_Filesystem)