wp_get_original_image_path()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_get_original_image_path( int $attachment_id, bool $unfiltered = false ): string|falseОписание
Аналогично get_attached_file(), однако некоторые изображения могли быть обработаны после загрузки, чтобы сделать их пригодными для использования в вебе. В этом случае прикреплённый файл размера «full» обычно заменяется уменьшенной версией исходного изображения. Эта функция всегда возвращает путь к изначально загруженному файлу изображения.
Оригинал (английский)
Similar to get_attached_file() however some images may have been processed after uploading to make them suitable for web use. In this case the attached “full” size file is usually replaced with a scaled down version of the original image. This function always returns the path to the originally uploaded image file.
Параметры
$attachment_id
int
обязательный
$unfiltered
bool
необязательный
= false
Возвращаемое значение
string|false
Исходный код
wp-includes/post.php:8460
function wp_get_original_image_path( $attachment_id, $unfiltered = false ) {
if ( ! wp_attachment_is_image( $attachment_id ) ) {
return 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'] );
}
/**
* Filters the path to the original image.
*
* @since 5.3.0
*
* @param string $original_image Path to original image file.
* @param int $attachment_id Attachment ID.
*/
return apply_filters( 'wp_get_original_image_path', $original_image, $attachment_id );
}История изменений
| Версия | Описание |
|---|---|
| 5.4.0 | Added the $unfiltered parameter. |
| 5.3.0 | Introduced. |
