wp_get_attachment_metadata

函数
wp_get_attachment_metadata ( $attachment_id = 0, $unfiltered = false )
参数
  • (int) $attachment_id Attachment post ID. Defaults to global $post.
    Required:
  • (bool) $unfiltered Optional. If true, filters are not run. Default false.
    Required:
    Default: false
返回值
  • (array|false) { Attachment metadata. False on failure. @type int $width The width of the attachment. @type int $height The height of the attachment. @type string $file The file path relative to `wp-content/uploads`. @type array $sizes Keys are size slugs, each value is an array containing 'file', 'width', 'height', and 'mime-type'. @type array $image_meta Image metadata. @type int $filesize File size of the attachment. }
定义位置
相关方法
wp_generate_attachment_metadatawp_update_attachment_metadatawp_maybe_generate_attachment_metadatawp_get_attachment_imagewp_get_attachment_caption
引入
2.1.0
弃用
-

wp_get_attachment_metadata: 这个函数检索一个附件的元数据。它将附件ID作为参数,并返回一个元数据数组,包括图像大小、MIME类型和文件路径。

根据附件ID来检索附件元数据。

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 );
}

常见问题

FAQs
查看更多 >