_wp_image_meta_replace_original()


WordPressの_wp_image_meta_replace_original()関数は、アップロードされた画像のメタデータを置き換えるために使用されます。主にメディアライブラリ内の画像情報を更新する際に利用されます。

構文

_wp_image_meta_replace_original( int $attachment_id, array $new_meta );

引数の説明:

  • $attachment_id (int) — メタデータを置き換える対象の添付ファイルID
  • $new_meta (array) — 新しいメタデータの配列

例1: 基本的なメタデータの置き換え

アップロードされた画像のメタデータを新しい配列で置き換えます。

_wp_image_meta_replace_original(get_the_ID(),array('width'=>800,'height'=>600));

例2: ファイル名の更新

画像のファイル名を含むメタデータを更新します。

_wp_image_meta_replace_original(attachment_url_to_postid('image.jpg'),array('file'=>'new_image.jpg'));

例3: サムネイルサイズの追加

新しいサムネイルサイズをメタデータに追加します。

_wp_image_meta_replace_original(get_post_thumbnail_id(),array('sizes'=>array('thumbnail'=>array('file'=>'thumb.jpg'))));

例4: EXIFデータの更新

画像のEXIF情報を新しいデータで更新します。

_wp_image_meta_replace_original(wp_get_attachment_image_src(get_the_ID())[0],array('image_meta'=>array('aperture'=>2.8)));

例5: オリエンテーションの変更

画像の向きに関するメタデータを変更します。

_wp_image_meta_replace_original(get_post()->ID,array('image_meta'=>array('orientation'=>1)));

例6: カメラモデル情報の追加

EXIFデータにカメラモデル情報を追加します。

_wp_image_meta_replace_original(get_attachment_id('photo.jpg'),array('image_meta'=>array('camera'=>'Canon EOS 5D')));

例7: メタデータの完全上書き

既存のメタデータを完全に新しいデータで上書きします。

_wp_image_meta_replace_original(get_queried_object_id(),array('width'=>1200,'height'=>900,'file'=>'full_image.jpg'));

注意事項

  • この関数は内部使用を目的としており、直接呼び出す場合は注意が必要です
  • メタデータを更新する前に適切なバックアップを取ってください
  • 不正なメタデータを渡すと画像表示に問題が発生する可能性があります

関連機能：