Описание функции wp_get_attachment_metadata()
Функция wp_get_attachment_metadata() получает метаданные для вложений, таких как изображения, аудио или видео. Она возвращает массив с информацией о размере, ориентации, пути к файлам и другой информации, связанной с вложением.
Эта функция полезна для получения дополнительной информации о медиафайлах, загруженных в библиотеку WordPress.
Параметры
$attachment_id
Тип: int
Обязательный: Да
Описание: ID вложения, для которого необходимо получить метаданные
Возможные значения:
Возвращаемое значение
Тип: array|false
Описание: Массив с метаданными вложения или false в случае ошибки
Возможные значения:
• Массив с метаданными (например, [‘width’ => 800, ‘height’ => 600])
• false если метаданные не найдены или ID вложения неверный
Примеры использования
Базовый пример получения метаданных для вложения с ID 42
$metadata = wp_get_attachment_metadata(42);
if ($metadata) {
echo 'Ширина: ' . $metadata['width'];
}
Ширина: 800
Пример обработки случая, когда метаданные не найдены
$metadata = wp_get_attachment_metadata(43);
if ($metadata === false) {
echo 'Метаданные не найдены';
}
Метаданные не найдены
Безопасность
Валидация входных данных: Функция проверяет, что переданный параметр является целым числом
Санитизация: Параметры автоматически проходят очистку в WordPress
Рекомендации: При выводе данных используйте функции для экранирования, такие как esc_html()
— Связанные функции
Обновляет метаданные вложения
Получает URL изображения и его размеры
— Хуки
Фильтрует метаданные перед их возвратом
— Примечания
– Ограничения
Функция работает только для вложений, имеющих метаданные
– Частые проблемы
- Возвращает false, если ID вложения неверен или метаданные отсутствуют
- Ошибки могут возникнуть при поврежденных данных вложения
