Получение URL изображения из вложения с помощью wp_get_attachment_image_url()

# WP_GET_ATTACHMENT_IMAGE_URL() │ WP 4.4.0

Функция wp_get_attachment_image_url() получает URL изображения из вложения.

**Использует:** wp_get_attachment_image_src()

**Отклики:** get_the_post_thumbnail_url()

**Производительность:** 
- 1 раз — 0.002972 сек (медленно) 
- 50000 раз — 10.29 сек (медленно) 

**Версия PHP:** 7.1.5, **Версия WP:** 4.8.1

**Хуки:** Нет

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

Строка или false. Возвращает URL вложения или false, если изображение недоступно. Если указанный размер ($size) не соответствует зарегистрированному размеру изображения, будет возвращен URL оригинального изображения.

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

```php
wp_get_attachment_image_url( $attachment_id, $size, $icon );

Параметры

• $attachment_id (int, обязательный) — ID изображения (вложения).
• $size (string|int[]) — Размер изображения. Может принимать любое имя зарегистрированного размера изображения или массив значений ширины и высоты в пикселях (в этом порядке). По умолчанию: 'thumbnail'.
• $icon (true|false) — Нужно ли рассматривать изображение как иконку. По умолчанию: false.

Примеры

Пример 1: Получение URL изображения вложения

// Для изображения
echo wp_get_attachment_image_url( 192 ) .'
';
echo wp_get_attachment_image_url( 192, 'full' ) .'
';

/* Результат будет:
http://example.com/wp-content/uploads/2010/12/kolobok3-80x80.jpg
http://example.com/wp-content/uploads/2010/12/kolobok3.jpg
*/

// Для файла
echo wp_get_attachment_image_url( 420 ) .'
';
echo wp_get_attachment_image_url( 420, '', 1 ) .'
';

/* Результат будет:
( пусто )
http://wp-kama.ru/core/wp-includes/images/media/archive.png
*/

Пример 2: Получение URL изображения вложения и отображение в тегах

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

С версии 4.4.0 — функция была введена.

Код функции

function wp_get_attachment_image_url( $attachment_id, $size = 'thumbnail', $icon = false ) {
    $image = wp_get_attachment_image_src( $attachment_id, $size, $icon );
    return isset( $image[0] ) ? $image[0] : false;
}

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

• wp_attachment_is_image()
• wp_get_attachment_caption()
• wp_get_attachment_image()
• wp_get_attachment_image_sizes()
• wp_get_attachment_image_src()
• wp_get_attachment_image_srcset()
• wp_get_attachment_thumb_url()
• wp_get_attachment_url()

Дополнительные категории функций

Миниатюры изображений

• add_image_size()
• delete_post_thumbnail()
• get_post_thumbnail_id()
• get_the_post_thumbnail()
• the_post_thumbnail()

Ссылки

• admin_url()
• home_url()
• site_url()

Эта улучшенная версия статьи объясняет функцию wp_get_attachment_image_url() более простым языком. Я включил примеры использования и пояснения к каждому параметру, чтобы даже начинающие пользователи WordPress могли легко понять, как использовать эту функцию.