wp_handle_upload

Вопросы и ответы

Как получить имя загруженного файла?

Имя загруженного файла можно получить из массива данных, который передается в хук wp_handle_upload. В этом массиве есть ключ file, который содержит имя файла.

add_filter( 'wp_handle_upload', 'my_handle_upload' );
function my_handle_upload( $upload ) {
    $file_name = $upload['file'];
    // Дальнейшая обработка имени файла
    return $upload;
}

Как получить URL загруженного файла?

URL загруженного файла также можно получить из массива данных, передаваемого в хук wp_handle_upload. В этом массиве есть ключ url, который содержит URL файла.

add_filter( 'wp_handle_upload', 'my_handle_upload' );
function my_handle_upload( $upload ) {
    $file_url = $upload['url'];
    // Дальнейшая обработка URL файла
    return $upload;
}

Как получить MIME-тип загруженного файла?

МIME-тип загруженного файла можно получить также из массива данных, передаваемого в хук wp_handle_upload. В этом массиве есть ключ type, который содержит MIME-тип файла.

add_filter( 'wp_handle_upload', 'my_handle_upload' );
function my_handle_upload( $upload ) {
    $mime_type = $upload['type'];
    // Дальнейшая обработка MIME-типа файла
    return $upload;
}

Как определить тип загрузки (upload или sideload)?

Для определения типа загрузки (upload или sideload) используется параметр $context в хуке wp_handle_upload. Значение этого параметра может быть ‘upload’ или ‘sideload’.

add_filter( 'wp_handle_upload', 'custom_handle_upload', 10, 2 );
function custom_handle_upload( $upload, $context ) {
    if ( $context === 'upload' ) {
        // Загрузка файла
    } elseif ( $context === 'sideload' ) {
        // Sideload загрузка файла
    }
    return $upload;
}

Как изменить данные о загруженном файле?

Для изменения данных о загруженном файле используется массив $upload в хуке wp_handle_upload. В этом массиве содержатся следующие элементы: file (имя файла), url (URL файла) и type (MIME-тип файла).

add_filter( 'wp_handle_upload', 'custom_handle_upload', 10, 2 );
function custom_handle_upload( $upload, $context ) {
    $upload['file'] = 'new-file-name.jpg';
    $upload['url'] = 'http://example.com/new-file-name.jpg';
    $upload['type'] = 'image/jpeg';
    return $upload;
}

Как добавить дополнительные проверки перед загрузкой файла?

Для добавления дополнительных проверок перед загрузкой файла используется хук wp_handle_upload_prefilter. В этом хуке можно проверить и изменить данные о загружаемом файле до его фактической загрузки.

add_filter( 'wp_handle_upload_prefilter', 'custom_handle_upload_prefilter' );
function custom_handle_upload_prefilter( $file ) {
    // Проверка и изменение данных о загружаемом файле
    if ( $file['type'] !== 'image/jpeg' ) {
        $file['error'] = 'Invalid file type.';
    }
    return $file;
}

Как обработать ошибку при загрузке файла?

Если при загрузке файла возникает ошибка, вы можете использовать хук wp_handle_upload_error для обработки этой ошибки и выполнения необходимых действий.

Пример использования хука:

add_filter( 'wp_handle_upload_error', 'my_handle_upload_error' );
function my_handle_upload_error( $upload_error ) {
    // Ваш код для обработки ошибки
    return $upload_error;
}

Как изменить путь сохранения загруженного файла?

Если вы хотите изменить путь сохранения загруженного файла, вы можете использовать хук upload_dir для изменения массива данных о пути.

Пример использования хука:

add_filter( 'upload_dir', 'my_upload_dir' );
function my_upload_dir( $upload_dir ) {
    // Ваш код для изменения пути сохранения файла
    return $upload_dir;
}

Как добавить дополнительные метаданные к загруженному файлу?

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

Пример использования хука:

add_filter( 'wp_generate_attachment_metadata', 'my_generate_attachment_metadata', 10, 2 );
function my_generate_attachment_metadata( $metadata, $attachment_id ) {
    // Ваш код для добавления дополнительных метаданных
    return $metadata;
}

Хук wp_handle_upload позволяет вам фильтровать массив данных о загруженном файле и выполнять различные действия в зависимости от типа загрузки. Вы можете использовать хуки wp_handle_upload_error, upload_dir и wp_generate_attachment_metadata для обработки ошибок, изменения пути сохранения файла и добавления дополнительных метаданных соответственно.