Функция WP_DELETE_ATTACHMENT_FILES() │ Удаление файлов вложения

# Функция WP_DELETE_ATTACHMENT_FILES() │ WP 4.9.7

Функция WP_DELETE_ATTACHMENT_FILES() удаляет все файлы, связанные с заданным вложением.

## Используется в

Функция wp_delete_attachment().

## Возврат значения

- **true** — если удаление прошло успешно.
- **false** — если произошла ошибка.

## Применение

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

Параметры

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

Примеры

Пример 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 );

Примечания

• Глобальная переменная: $wpdb — объект абстракции базы данных WordPress.

Изменения

• С версии 4.9.7 — функция была добавлена в WordPress.

Код функции wp_delete_attachment_files

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

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

    if ( ! empty( $meta['thumb'] ) ) {
        // Не удаляем миниатюру, если другое вложение ее использует.
        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;
                }
            }
        }
    }

    // Удаляем промежуточные и резервные изображения, если они есть.
    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;
}

Эта функция полезна для тех, кто хочет управлять файлами вложений в WordPress, особенно если нужно удалить ненужные изображения и освободить место на сервере.