wp_get_attachment_metadata() — описание функции WordPress на русском

Сигнатура

wp_get_attachment_metadata( int $attachment_id, bool $unfiltered = false ): array|false

Описание

Возвращает метаданные вложения по его ID.

Параметры

$attachment_id int обязательный

ID записи вложения. По умолчанию — глобальный $post.

$unfiltered bool необязательный = false

Если true, фильтры не выполняются.

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

array|false

width intШирина вложения. height intВысота вложения. file stringПуть к файлу относительно wp-content/uploads. sizes arrayКлючи — слаги размеров, каждое значение — массив, содержащий 'file', 'width', 'height' и 'mime-type'. image_meta arrayМетаданные изображения. filesize intРазмер файла вложения.

Исходный код

wp-includes/post.php:6889

function wp_get_attachment_metadata( $attachment_id = 0, $unfiltered = false ) {
	$attachment_id = (int) $attachment_id;

	if ( ! $attachment_id ) {
		$post = get_post();

		if ( ! $post ) {
			return false;
		}

		$attachment_id = $post->ID;
	}

	$data = get_post_meta( $attachment_id, '_wp_attachment_metadata', true );

	if ( ! $data ) {
		return false;
	}

	if ( $unfiltered ) {
		return $data;
	}

	/**
	 * Filters the attachment meta data.
	 *
	 * @since 2.1.0
	 *
	 * @param array $data          Array of meta data for the given attachment.
	 * @param int   $attachment_id Attachment post ID.
	 */
	return apply_filters( 'wp_get_attachment_metadata', $data, $attachment_id );
}

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

Версия	Описание
6.0.0	The $filesize value was added to the returned array.
2.1.0	Introduced.