wp_get_attachment_url()


WordPressの関数wp_get_attachment_url()は、特定の添付ファイル（画像、PDFなど）のURLを取得するために使用されます。この関数は、投稿IDを引数として受け取り、その添付ファイルの完全なURLを返します。

構文

wp_get_attachment_url( int $attachment_id );
  • $attachment_id (int) — 添付ファイルの投稿ID。

例1: 添付ファイルのURLを取得

指定したIDの添付ファイルURLを取得します。

<?php 
echo wp_get_attachment_url( get_post_thumbnail_id() ); 
?>

例2: URLをリンクとして表示

添付ファイルのURLをリンク形式で出力します。

<?php 
$attachment_url = wp_get_attachment_url( get_post_thumbnail_id() );
echo '<a href="' . $attachment_url . '">ファイルをダウンロード</a>'; 
?>

例3: カスタム投稿タイプで使用

特定のカスタム投稿タイプのアイキャッチ画像URLを取得します。

<?php 
if ( 'custom_post_type' === get_post_type() ) {
    echo wp_get_attachment_url( get_post_thumbnail_id() );
} 
?>

例4: 添付ファイルのURLをJavaScriptに渡す

URLをスクリプトで利用するためにJavaScript変数に格納します。

<?php 
$attachment_url = wp_get_attachment_url( get_post_thumbnail_id() );
echo '<script>const attachmentUrl = "' . $attachment_url . '";</script>'; 
?>

例5: 複数の添付ファイルのURLを取得

ギャラリー形式で登録されたすべての添付ファイルURLを取得します。

<?php 
$attachments = get_attached_media( 'image' );
foreach ( $attachments as $attachment ) {
    echo wp_get_attachment_url( $attachment->ID ) . '<br>';
}
?>

注意事項

  • この関数は投稿IDが正しく指定されない場合、NULLを返します。
  • 添付ファイルが存在しない場合や削除された場合、無効なURLを返す可能性があります。

関連機能：