wp_read_image_metadata

（2.5.0以降）
wp_read_image_metadata - 画像ファイルのメタ情報を取得する

説明

bool | array wp_read_image_metadata( string $file )

画像ファイルのメタ情報を取得する。

パラメータ

$path
ファイルのパス名を指定。

返り値

IPTCまたはEXIF情報を取得できた場合は連想配列を、それ以外はfalseを返す。

注意

PHPのiptcparse関数およびexif_read_data関数を使用するため、それらが使用できないPHP環境の場合は有効に機能しない。

IPTCとEXIF情報の両方を取得できた場合、同義の項目はIPTC情報が優先される。

メタ情報	IPTC	EXIF
$meta['title']	$iptc['2#105'] または $iptc['2#005'] または $iptc['2#120']	$exif['ImageDescription']
$meta['caption']	$iptc['2#120']	$exif['COMPUTED']['UserComment'] または $exif['ImageDescription'] または $exif['Comments']
$meta['credit']	$iptc['2#110'] または $iptc['2#080']	$exif['Artist'] または $exif['Author']
$meta['copyright']	－	$exif['Copyright']
$exif['FNumber']	－	$exif['FNumber']
$meta['camera']	－	$exif['Model']
$meta['created_timestamp']	$iptc['2#055'] と $iptc['2#060']	$exif['DateTimeDigitized']
$meta['focal_length']	－	$exif['FocalLength']
$meta['iso']	－	$exif['ISOSpeedRatings']
$meta['shutter_speed']	－	$exif['ExposureTime']
$meta['orientation']	－	$exif['Orientation']
$meta['copyright']	$iptc['2#116']	－
$meta['keywords']	$iptc['2#025']	－

使用例

画像ファイルのメタ情報を取得する。

フィルター

[2.5.0]EXIF情報を取得する前に'wp_read_image_metadata_types'フィルターを呼び出す。パラメータ$image_typesはEXIFに対応するイメージタイプの配列が格納されている。

$exif_image_types = apply_filters( 'wp_read_image_metadata_types', $image_types );

[2.5.0]メタ情報を返す前に'wp_read_image_metadata'フィルターを呼び出す。パラメータ$metaにはメタ情報が、$fileには本関数が受け取った内容が、$image_typeには$fileのイメージタイプが格納されている。[4.4.0]$iptcにはIPTC情報が格納されている。[5.0.0]$exifにはEXIF情報が格納されている。

return apply_filters( 'wp_read_image_metadata', $meta, $file, $image_type, $iptc, $exif );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-admin/includes/image.php

最終更新 : 2019年06月14日 11:22

参考

Code Reference: wp_read_image_metadata

お勧め

個人データのエクスポートメール向けに追加された新フィルター（2020年4月2日更新）

先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。

決まった値を返すだけの関数群（2018年5月27日更新）

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

サイドバーの初期化はwidgets_initアクションで（2011年7月14日更新）

ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。

Gutenbergでカスタムフィールドを使う（2018年8月10日更新）

Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。

favicon.icoがWordPressロゴになる！？（2020年2月25日更新）

先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。