当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

関数リファレンス/wp read image metadata

提供: WordPress Codex 日本語版
< 関数リファレンス
2018年5月4日 (金) 17:50時点におけるGblsm (トーク | 投稿記録)による版 (途中まで翻訳。)

移動先: 案内検索

このページ「関数リファレンス/wp read image metadata」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

画像ファイルの拡張メタデータ(付加されている EXIF または IPTC)を取得します。

EXIF メタデータは aperture, credit, camera, caption, copyright, iso created_timestamp, focal_length, shutter_speed, および title を取得します。

IPTC メタデータは APP13, credit, byline, created date and time, caption, copyright, および title を取得します。さらに FNumber, Model, DateTimeDigitized, FocalLength, ISOSpeedRatings, および ExposureTime も含まれます。

使い方

<?php wp_read_image_metadata( $file ); ?>

パラメータ

$file
string) (必須) 画像ファイルの絶対パス。
初期値: なし

戻り値

(真偽値|配列) 
失敗すると false を返します。成功すると画像のメタデータの配列を返します。

返される配列の要素は次のとおりです:

["aperture"] 
(string) Set to the EXIF FNumber field.
["credit"] 
(string) Set to the first non-empty value found by looking through the following fields:
  1. IPTC Credit field (2#110)
  2. IPTC Creator field (2#080)
  3. EXIF Artist field
  4. EXIF Author field
["camera"] 
(string) Set to the EXIF Model field.
["caption"] 
(string) Set to a non-empty value of one of the following fields (see source code for the precise logic involved):
  1. IPTC Description field (2#120)
  2. EXIF UserComment field if [“title”] is unset AND EXIF:ImageDescription is less than 80 characters
  3. EXIF ImageDescription field if [“title”] is set OR EXIF:ImageDescription is more than 80 characters
  4. EXIF Comments field if [“title”] does not equal EXIF:Comments
["created_timestamp"] 
(string) Set to the first non-empty value found by looking through the following fields:
  1. EXIF field DateTimeDigitized
  2. IPTC Date and Time fields (2#055 and 2#060)
["copyright"] 
(string) Set to the first non-empty value found by looking through the following fields:
  1. IPTC Copyright field (2#116)
  2. EXIF Copyright field
["focal_length"] 
(string) Set to the EXIF FocalLength field.
["iso"] 
(string) Set to the EXIF ISOSpeedRatings field.
["shutter_speed"] 
(string) Set to the EXIF ExposureTime field.
["title"] 
(string) Set to the first non-empty value found by looking through the following fields:
  1. IPTC Headline field (2#105)
  2. IPTC Title field (2#005)
  3. IPTC Description field (2#120) but only if less than 80 characters
  4. EXIF Title field
  5. EXIF ImageDescription field but only if less than 80 characters

参考: The (2#nnn) value shown after each IPTC field (above) is the key of the array returned by PHP’s iptcparse function for that particular IPTC field.

用例

参考

この関数を呼び出して次のようなエラーが発生した場合は:

PHP Fatal error: Uncaught Error: Call to undefined function wp_read_image_metadata() ...

ファイル wp-admin/includes/image.php をインクルードしてください:

<?php
require_once ABSPATH . '/wp-admin/includes/image.php';
 
$path = '/path/to/file.jpg';
 
wp_read_image_metadata( $path );
?>

変更履歴

新規導入 : 2.5

ソースファイル

wp_read_image_metadata()wp-admin/includes/image.php にあります。

関連項目

関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: Reference / Functions / wp_read_image_metadata()