# wp_delete_attachment_files()

URL: https://chugunov.pro/api-wordpress/functions/wp_delete_attachment_files/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.9.7.

## Сигнатура

```php
wp_delete_attachment_files( int $post_id, array $meta, array $backup_sizes, string $file ): bool
```

## Описание

Удаляет все файлы, принадлежащие указанному вложению.

## Параметры

- `$post_id` `int` — обязательный. Идентификатор вложения.
- `$meta` `array` — обязательный. Метаданные вложения.
- `$backup_sizes` `array` — обязательный. Метаданные резервных копий изображений вложения.
- `$file` `string` — обязательный. Абсолютный путь к файлу вложения.

## Возвращаемое значение

`bool`

## Исходный код

Файл: `wp-includes/post.php:6791`

```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'] ) ) {
		// Don't delete the thumb if another attachment uses it.
		if ( ! $wpdb->get_row( $wpdb->prepare( "SELECT meta_id FROM $wpdb->postmeta WHERE meta_key = '_wp_attachment_metadata' AND meta_value LIKE %s AND post_id <> %d", '%' . $wpdb->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;
}
```

## История изменений

- 4.9.7 — Introduced.

## Связанные

Использует: [`wp_delete_file_from_directory`](https://chugunov.pro/api-wordpress/functions/wp_delete_file_from_directory/), [`wp_get_upload_dir`](https://chugunov.pro/api-wordpress/functions/wp_get_upload_dir/), `wpdb::esc_like`, [`path_join`](https://chugunov.pro/api-wordpress/functions/path_join/), `wpdb::get_row`, [`wp_basename`](https://chugunov.pro/api-wordpress/functions/wp_basename/), `wpdb::prepare`.
Используется в: [`wp_delete_attachment`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_delete_attachment_files/