Описание функции wp_get_attachment_image_url()
Функция wp_get_attachment_image_url() возвращает URL-адрес изображения, связанного с вложением, в зависимости от указанного размера. Она используется для получения изображений, загруженных в медиа-библиотеку, и позволяет указать нужный размер изображения.
Функция полезна в темах и плагинах, когда требуется отображение изображений, связанных с записями или страницами.
Параметры
$attachment_id
Тип: int
Обязательный: Да
Описание: ID вложения (изображения), для которого нужно получить URL
Возможные значения:
$size
Тип: string
Обязательный: Нет
По умолчанию: full
Описание: Размер изображения, который нужно вернуть
Возможные значения:
0: thumbnail
1: medium
2: large
3: full
Возвращаемое значение
Тип: string|null
Описание: URL-адрес изображения или null, если не найдено
Возможные значения:
• Строка с URL-адресом изображения при успешном выполнении
• null если вложение не найдено или не является изображением
Примеры использования
Базовый пример получения URL изображения
$url = wp_get_attachment_image_url(123, 'medium');
// Выводит URL-адрес изображения размером medium
echo $url;
URL-адрес изображения будет выведен, если ID 123 является изображением
Пример получения URL миниатюры изображения
$url = wp_get_attachment_image_url(456, 'thumbnail');
// Выводит URL-адрес миниатюры изображения
echo $url;
Если ID 456 не существует, будет возвращено null
Пример обработки случая, когда изображение не найдено
$url = wp_get_attachment_image_url(9999, 'full');
if ($url === null) {
echo 'Изображение не найдено';
} else {
echo $url;
}
ID 9999, вероятно, не существует в медиа-библиотеке
Безопасность
Валидация входных данных: Параметр attachment_id проходит валидацию на целое число
Санитизация: Функция автоматически очищает входные данные
Рекомендации: При выводе URL используйте esc_url() для безопасного отображения
— Связанные функции
Возвращает HTML-код для отображения изображения вложения
Получает ID миниатюры записи
— Хуки
Фильтрует URL-адрес изображения перед его возвратом
— Примечания
– Ограничения
Возвращает null, если передан неверный ID или вложение не является изображением
– Частые проблемы
- Пустой результат при неправильном ID
- Неверный размер изображения, если не поддерживается
