WP_GET_ORIGINAL_IMAGE_PATH() │ WP 5.3.0

Функция WP_GET_ORIGINAL_IMAGE_PATH() позволяет получить путь к загруженному изображению.

Описание функции

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

Вызов функций

• get_attached_file()
• wp_attachment_is_image()
• wp_get_attachment_metadata()

Производительность

• 1 раз — 0.0014172 сек (очень медленно)
• 50000 раз — 1.04 сек (быстро)

Хуки функции

• wp_get_original_image_path

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

Строка | false. Путь к оригинальному файлу изображения или false, если вложение не является изображением.

Использование

wp_get_original_image_path( $attachment_id, $unfiltered );

• $attachment_id (int) (обязательный) — ID (идентификатор) вложения.
• $unfiltered (true|false) — передаётся в get_attached_file().
  • По умолчанию: false

Примеры

1. Вывод пути к изображению

$attach_path = wp_get_original_image_path( 516 );

if ( $attach_path ) {
    echo $attach_path; // Выводит путь к изображению
} else {
    echo 'Этот файл не является изображением или указанное изображение не существует';
}

Изменения

• С версии 5.3.0 — введена функция.
• С версии 5.4.0 — добавлен параметр $unfiltered.

Код функции

function wp_get_original_image_path( $attachment_id, $unfiltered = false ) {
    if ( ! wp_attachment_is_image( $attachment_id ) ) {
        return false; // Если это не изображение, возвращаем false
    }

    $image_meta = wp_get_attachment_metadata( $attachment_id ); // Получаем метаданные изображения
    $image_file = get_attached_file( $attachment_id, $unfiltered ); // Получаем файл изображения

    if ( empty( $image_meta['original_image'] ) ) {
        $original_image = $image_file; // Если нет оригинала, используем текущий файл
    } else {
        $original_image = path_join( dirname( $image_file ), $image_meta['original_image'] ); // Путь к оригинальному изображению
    }

    /**
     * Фильтрует путь к оригинальному изображению.
     *
     * @since 5.3.0
     *
     * @param string $original_image Путь к оригинальному файлу изображения.
     * @param int    $attachment_id  ID вложения.
     */
    return apply_filters( 'wp_get_original_image_path', $original_image, $attachment_id );
}

Связанные функции

Изображения миниатюры

• add_image_size()
• delete_post_thumbnail()
• get_intermediate_image_sizes()
• get_post_thumbnail_id()
• get_the_post_thumbnail()
• get_the_post_thumbnail_caption()
• get_the_post_thumbnail_url()
• has_image_size()
• has_post_thumbnail()
• image_downsize()
• image_get_intermediate_size()
• remove_image_size()
• set_post_thumbnail()
• set_post_thumbnail_size()
• the_post_thumbnail()
• the_post_thumbnail_caption()
• the_post_thumbnail_url()
• wp_get_attachment_image_url()
• wp_get_image_editor()
• wp_get_original_image_url()

Вложенные медиафайлы

• get_attached_file()
• get_attached_media()
• get_attachment_link()
• get_children()
• get_post_mime_type()
• is_local_attachment()
• the_attachment_link()
• wp_attachment_is()
• wp_delete_attachment()
• wp_get_attachment_link()
• wp_get_attachment_url()
• wp_insert_attachment()

Теперь вы знаете, как использовать функцию WP_GET_ORIGINAL_IMAGE_PATH() для получения пути к оригинальному изображению в WordPress!