wp_create_image_subsizes()


WordPressのwp_create_image_subsizes()関数は、アップロードされた画像のサブサイズ（サムネイルやその他のサイズバリエーション）を生成するために使用されます。この関数は通常、メディアライブラリに画像が追加されたときに自動的に呼び出されます。

構文

wp_create_image_subsizes( int $attachment_id, string $file = '' );

引数の説明:

  • $attachment_id (int) — メディアライブラリ内の画像のID
  • $file (string) — 画像ファイルのパス（オプション）

例1: 基本的な使用方法

アップロードされた画像のサブサイズを生成します。

wp_create_image_subsizes(get_post_thumbnail_id());

例2: カスタムアタッチメントIDを指定

特定のメディアアイテムに対してサブサイズを生成します。

wp_create_image_subsizes(123);

例3: ファイルパスを指定して実行

直接ファイルパスを指定してサブサイズを生成します。

wp_create_image_subsizes(0, '/path/to/image.jpg');

例4: フックと組み合わせて使用

画像アップロード後に自動的に実行されるように設定します。

add_action('add_attachment', function($id){wp_create_image_subsizes($id);});

例5: エラーハンドリング

関数の実行結果をチェックします。

if(false===wp_create_image_subsizes($id)){error_log('画像サイズ生成に失敗');}

例6: 特定の画像サイズのみ生成

事前に登録されたサイズのみを生成します。

add_filter('intermediate_image_sizes',function($sizes){return['thumbnail','medium'];});wp_create_image_subsizes($id);

例7: 外部からの画像処理

WordPress外の画像に対してサブサイズを生成します。

wp_create_image_subsizes(0,ABSPATH.'external-images/photo.jpg');

注意事項

  • この関数はサーバーリソースを消費します
  • 大量の画像を処理する場合はタイムアウトに注意が必要です
  • ファイルパスを指定する場合は適切なパーミッションが必要です

関連機能：