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

メディア・画像

attachment_url_to_postid() は、添付ファイルのURLから、添付ファイルIDを取得する関数です。

2026.10.03

説明

attachment_url_to_postid() は、添付ファイルのURLから、添付ファイルIDを取得する関数です。

attachment_url_to_postid( string $url ): int

添付ファイルのID。見つからなければ 0。

$id = attachment_url_to_postid( 'https://example.com/wp-content/uploads/2026/01/sample.jpg' );

外部のURLや、メディアにないURLでは 0 が返る。確認せずに使う。
データベースを検索するため、重い。繰り返し呼ぶ場合は、結果をキャッシュする。
サイズ違いのURL（-300x200 など）や、-scaled を含まない元のURLは、一致せず 0 になる。アップロード時に保存された、本体のURLを渡す。

NG例

$id = attachment_url_to_postid( $url );
echo wp_get_attachment_url( $id ); // 0 のときも処理してしまう

OK例

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