wp_get_attachment_image_src()

基本構文と使い方（引数・実行結果）

指定した添付画像（管理画面からメディアに登録された画像）の情報を取得する。

wp_get_attachment_image_src($attachment_id,$size,$icon);

Copy

wp_get_attachment_image_src($attachment_id,$size,$icon);

引数	必須/任意	引数に指定するもの
第１引数 $attachment_id	必須	画像の`ID` （整数）
第２引数 $size	任意	画像サイズを下記から指定。 `thumbnail`（設定→メディアのサムネイルサイズ） `medium`（設定→メディアの中サイズ） `medium_large`（横幅768px） `large`（設定→メディアの大サイズ） `full`（オリジナルサイズ）初期値：`thumbnail`（テーマ次第）あるいは配列での指定も可能。例：`[500,300]`（横500px、縦300pxに収める）
第３引数 $icon	任意	第１引数で指定したIDが画像ではない場合のフォールバックとして、アイコンを取得するかどうか。表示する場合`true`、表示しない場合`false` 初期値：`false` trueにすると、例えばメディアにアップロードしたExcelファイルを読み込もうとするとWordPressに標準で登録されているExcelアイコンを取得します。

戻り値（返す値）：取得した画像情報の配列（第１引数で指定した画像がない場合はfalseを返す）
なお返ってきた配列は4つの要素を持ち、それぞれ以下の情報が含まれます。

$img = wp_get_attachment_image_src(30); //例：ID30の画像情報を配列で取得
$img[0] // 画像のURL
$img[1] // 画像の横幅
$img[2] // 画像の縦幅
$img[3] // リサイズされているかどうか（true/false）

Copy

$img = wp_get_attachment_image_src(30); //例：ID30の画像情報を配列で取得
$img[0] // 画像のURL
$img[1] // 画像の横幅
$img[2] // 画像の縦幅
$img[3] // リサイズされているかどうか（true/false）

下記例ではID30のフルサイズの画像情報からURL（インデックス0）を取得して変数に格納しています。

$img_url = wp_get_attachment_image_src(30,'full')[0]

Copy

$img_url = wp_get_attachment_image_src(30,'full')[0]

結果例：https://example.com/wp-content/themes/my_theme/img/my-image.jpg

【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。

【引数について】

指定できる引数の数はテンプレートタグによって異なります。（引数なしもあり）
引数ごとに必須 / 任意が決まっています。（必須は必ず指定、任意は指定しなければ初期値）
引数名(例：$post)は仕様の便宜上の名前と考えてください。（この名前自体はテンプレートタグ実行に関係しません。各引数に何を指定するのかを理解していればOKです。）

※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。

テンプレートタグ	説明
get_template_directory_uri()	テーマディレクトリのURLを取得します。子テーマ利用時も常に親テーマのURLを取得します。
wp_get_attachment_image()	指定した添付画像（管理画面からメディアに登録された画像）のimg要素を取得する。
get_theme_file_uri()	テーマディレクトリのURLを取得します。子テーマ利用時は子テーマディレクトリのURLを取得します。
home_url()	トップページのURLを取得します。

Akiyuki Tanaka

2014年にフリーランス（Webデザイナー／コーダー）として独立。2016年にWeb制作会社ソーイ株式会社を設立し、現在までWeb制作・開発の現場に携わってきました。

初学者だった頃は、学習に苦労し随分と遠回りしました。かつての自分と同じような人に提供できるものがあるのではないかと考え、YouTubeでの講義配信を経て、より体系的で実践的な学習環境を提供する、独自の学習プラットフォーム unazuki を立ち上げました。

制作と教育、両方の現場に立ってきた経験を活かし、「とりあえずコードが書ける」ではなく、考えて作れるWeb制作者を増やすことを目指しています。