wp_get_attachment_image_url()


WordPressのwp_get_attachment_image_url()関数は、指定された添付ファイルの画像URLを取得するために使用されます。

構文

wp_get_attachment_image_url( int $attachment_id, string|array $size = 'thumbnail', bool $icon = false );

引数の説明:

  • $attachment_id(int) — 画像の添付ファイルIDを指定します。
  • $size(string|array) — 画像サイズを指定します。デフォルトは’thumbnail’です。
  • $icon(bool) — アイコンを使用するかどうかを指定します。デフォルトはfalseです。

例1: サムネイル画像のURLを取得

この例では、投稿の最初の画像のサムネイルURLを取得します。

<?php $thumbnail_url = wp_get_attachment_image_url( get_post_thumbnail_id( get_the_ID() ), 'thumbnail' ); echo $thumbnail_url; ?>

例2: フルサイズの画像URLを取得

この例では、指定された添付ファイルIDのフルサイズ画像URLを取得します。

<?php $full_size_url = wp_get_attachment_image_url( 123, 'full' ); echo $full_size_url; ?>

例3: カスタムサイズの画像URLを取得

この例では、カスタムサイズの画像URLを取得します。

<?php $custom_size_url = wp_get_attachment_image_url( 123, array( 300, 200 ) ); echo $custom_size_url; ?>

例4: アイコン画像のURLを取得

この例では、添付ファイルのアイコン画像URLを取得します。

<?php $icon_url = wp_get_attachment_image_url( 123, 'thumbnail', true ); echo $icon_url; ?>

例5: ループ内で画像URLを取得

この例では、ループ内で各投稿のサムネイル画像URLを取得します。

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); $thumbnail_url = wp_get_attachment_image_url( get_post_thumbnail_id(), 'thumbnail' ); echo $thumbnail_url; endwhile; endif; ?>

例6: 特定の添付ファイルのURLを取得

この例では、特定の添付ファイルIDを使用して画像URLを取得します。

<?php $attachment_url = wp_get_attachment_image_url( 456, 'medium' ); echo $attachment_url; ?>

注意点

  • 指定された添付ファイルIDが存在しない場合、関数はfalseを返します。
  • 画像サイズが登録されていない場合、デフォルトのサイズが使用されます。

関連機能：