wp_delete_file()
Видаляє файл. Обгортка для PHP функції unlink() , в якій спрацьовує однойменний хук wp_delete_file .
Функція запускає PHP функцію unlink() , але застосовує фільтр wp_delete_file . У фільтр передається шлях файлу, що видаляється, якщо фільтр що-небудь поверне (поверне не порожнє значення), то спрацює unlink() .
Основа для:
wp_delete_file_from_directory()
wp_delete_file_from_directory()
Хуки з функції
Повертає
null. Нічого.
Використання
wp_delete_file($file);
- $file
(рядок) (обов’язковий) - Шлях до файлу, який потрібно видалити.
Приклади
#1 Видалимо файл test.txt з каталогу завантажень uploads
$upload_info = wp_get_upload_dir(); $file = $upload_info['basedir'] . '/test.txt'; wp_delete_file($file);
#2 Заборонимо видалення файлів з ім’ям test.txt за допомогою фільтра
Тепер приклад вище не видалити файл test.txt.
add_filter( 'wp_delete_file', function ( $file ) {
if ( 'test.txt' === basename( $file ) )
return '';
return $file;
} );
список змін
| З версії 4.2.0 | Введено. |
Код wp_delete_file() wp delete file WP 6.0.2
function wp_delete_file( $file ) {
/**
* Filters path of file to delete.
*
* @ Since 2.1.0
*
* @param string $file Path to the file to delete.
*/
$delete = apply_filters( 'wp_delete_file', $file );
if ( ! empty( $delete ) ) {
@unlink($delete);
}
}