wp_image_file_matches_image_meta()


WordPressのwp_image_file_matches_image_meta()関数は、画像ファイルが指定されたメタデータと一致するかどうかを確認するために使用されます。

構文

wp_image_file_matches_image_meta( string $file, array $image_meta );

引数の説明:

  • $file(string)—画像ファイルのパス
  • $image_meta(array)—画像のメタデータを含む配列

例1: 基本的な使用法

画像ファイルがメタデータと一致するか確認します。

$result = wp_image_file_matches_image_meta( '/path/to/image.jpg', $image_meta );

例2: アップロードディレクトリ内の画像をチェック

アップロードされた画像がメタデータと一致するか検証します。

$upload_dir = wp_upload_dir(); $result = wp_image_file_matches_image_meta( $upload_dir['path'] . '/image.jpg', $image_meta );

例3: サムネイル画像の確認

サムネイル画像がメタデータと一致するかテストします。

$thumbnail = get_post_thumbnail_id( get_the_ID() ); $meta = wp_get_attachment_metadata( $thumbnail ); $result = wp_image_file_matches_image_meta( get_attached_file( $thumbnail ), $meta );

例4: 外部URLの画像を検証

外部URLの画像がメタデータと一致するか確認します。

$result = wp_image_file_matches_image_meta( 'https://example.com/image.jpg', $image_meta );

例5: 編集後の画像をチェック

編集後の画像が元のメタデータと一致するか調べます。

$edited_image = '/path/to/edited-image.jpg'; $result = wp_image_file_matches_image_meta( $edited_image, $original_meta );

例6: 複数サイズの画像を検証

複数の画像サイズがメタデータと一致するか確認します。

foreach( $image_meta['sizes'] as $size ) { $result = wp_image_file_matches_image_meta( '/path/to/' . $size['file'], $image_meta ); }

例7: ファイルが存在しない場合の処理

ファイルが存在しない場合のエラーハンドリングを行います。

if( !file_exists( $file ) ) { return false; } $result = wp_image_file_matches_image_meta( $file, $image_meta );

注意点

  • ファイルパスは絶対パスで指定する必要があります
  • 画像メタデータはwp_get_attachment_metadata()で取得できます
  • 関数は論理値を返します

関連機能：