wp_get_attachment_url() の使い方｜説明・引数・注意点

メディア・画像

wp_get_attachment_url() は、添付ファイル（メディア）のURLを返す関数です。

2026.10.03

説明

wp_get_attachment_url() は、添付ファイル（メディア）のURLを返す関数です。

wp_get_attachment_url( int $attachment_id = 0 ): string|false

ファイルのURL。存在しなければ false。

echo esc_url( wp_get_attachment_url( 45 ) );

サイズ違いの画像のURLが欲しいのに、これを使っている。この関数が返すのは、元のファイル（フルサイズ）のURL。サイズ指定は wp_get_attachment_image_src() を使う。
投稿のIDを渡している。渡すのは、添付ファイルのID。アイキャッチ画像のIDは、get_post_thumbnail_id() で取得する。
存在しないIDでは false が返る。確認せずに出力する。

NG例

echo wp_get_attachment_url( get_the_ID() ); // 投稿のIDを渡している

OK例

$url = wp_get_attachment_url( get_post_thumbnail_id() );
if ( $url ) {
	echo esc_url( $url );
}