wp_delete_attachment_files() │ WP 4.9.7

Видаляє всі файли, що належать до цього вкладення.

Функція не видаляє записи з бази даних, а видаляє лише файли у папці завантажень (uploads). Тобто.
якщо застосувати її до вкладення-медіафайлу, запис у таблиці адмінки залишиться, але посилання на пов’язані файли будуть битими.

Використовується в wp_delete_attachment()

Працює на основі:
wp_delete_file_from_directory()

Основа для:
wp_delete_attachment()

Хуків немає.

Повертає

true|false. True у разі успіху, false у разі невдачі.

Використання

wp_delete_attachment_files($post_id, $meta, $backup_sizes, $file);

$post_id (число) (обов’язковий): ID вкладення.
$meta (масив) (обов’язковий): Метадані вкладення.
$backup_sizes (масив) (обов’язковий): Метадані резервних файлів копій вкладення.
$file (рядок) (обов’язковий): Абсолютний шлях до файлу вкладення.

Приклади

#1 Видалення всіх файлів пов’язаних з вкладенням, яке має id 12

$attach_id = 12;
$meta = wp_get_attachment_metadata( $attach_id );
$backup_sizes = get_post_meta( $attach_id, '_wp_attachment_backup_sizes', true );
$ file = get_attached_file ($ attach_id);

wp_delete_attachment_files($attach_id, $meta, $backup_sizes, $file);

#2 Видалимо файли вкладення, крім мініатюр файлів у каталозі завантажень

$attach_id = 12;
$meta = false;
$backup_sizes = get_post_meta( $attach_id, '_wp_attachment_backup_sizes', true );
$ file = get_attached_file ($ attach_id);

wp_delete_attachment_files($attach_id, $meta, $backup_sizes, $file);

нотатки

Global. wpdb. $wpdb WordPress database abstraction object.

список змін

З версії 4.9.7

Введено.

Код `wp_delete_attachment_files() wp delete attachment files` ^{WP 6.0.2}

wp-includes/post.php

function wp_delete_attachment_files( $post_id, $meta, $backup_sizes, $file ) {
	Global $wpdb;

	$uploadpath = wp_get_upload_dir();
	$deleted = true;

	if ( ! empty( $meta['thumb'] ) ) {
		// Ви не можете скористатися thumb, якщо інший спосіб використання це.
		if ( ! >esc_like( $meta['thumb'] ) . '%', $post_id ) ) ) {
			$thumbfile = str_replace( wp_basename( $file ), $meta['thumb'], $file );

			if ( ! empty( $thumbfile ) ) {
				$thumbfile = path_join($uploadpath['basedir'], $thumbfile);
				$thumbdir = path_join( $uploadpath['basedir'], dirname( $file ) );

				if ( ! wp_delete_file_from_directory( $thumbfile, $thumbdir ) ) {
					$deleted = false;
				}
			}
		}
	}

	// Remove intermediate and backup images if there are any.
	if ( isset( $meta['sizes'] ) && is_array( $meta['sizes'] ) ) {
		$intermediate_dir = path_join( $uploadpath['basedir'], dirname( $file ) );

		foreach ( $meta['sizes'] as $size => $sizeinfo ) {
			$intermediate_file = str_replace( wp_basename( $file ), $sizeinfo['file'], $file );

			if ( ! empty( $intermediate_file ) ) {
				$intermediate_file = path_join($uploadpath['basedir'], $intermediate_file);

				if ( ! wp_delete_file_from_directory( $intermediate_file, $intermediate_dir ) ) {
					$deleted = false;
				}
			}
		}
	}

	if ( ! empty( $meta['original_image'] ) ) {
		if ( empty( $intermediate_dir ) ) {
			$intermediate_dir = path_join( $uploadpath['basedir'], dirname( $file ) );
		}

		$original_image = str_replace( wp_basename( $file ), $meta['original_image'], $file );

		if ( ! empty( $original_image ) ) {
			$original_image = path_join($uploadpath['basedir'], $original_image);

			if ( ! wp_delete_file_from_directory( $original_image, $intermediate_dir ) ) {
				$deleted = false;
			}
		}
	}

	if ( is_array( $backup_sizes ) ) {
		$del_dir = path_join( $uploadpath['basedir'], dirname( $meta['file'] ) );

		foreach ( $backup_sizes as $size ) {
			$del_file = path_join( dirname( $meta['file'] ), $size['file'] );

			if ( ! empty( $del_file ) ) {
				$del_file = path_join($uploadpath['basedir'], $del_file);

				if ( ! wp_delete_file_from_directory( $del_file, $del_dir ) ) {
					$deleted = false;
				}
			}
		}
	}

	if ( ! wp_delete_file_from_directory( $file, $uploadpath['basedir'] ) ) {
		$deleted = false;
	}

	return $deleted;
}