関数リファレンス/wp get attachment url

説明

添付ファイルのフル URI を返します。失敗すると false を返します。

使い方

<?php wp_get_attachment_url( $id ); ?>

デフォルトの使い方

<?php echo wp_get_attachment_url( 12 ); ?> 

上記のコードは例えば http://example.net/wp-content/uploads/ファイル名 のように出力します。

パラメータ

$id

（整数） （必須） 添付ファイルの ID

初期値： なし

戻り値

(文字列/真偽値) 

アップロードした添付ファイルの URI を返す。失敗すると false を返す。

デフォルトの使い方

<?php echo wp_get_attachment_url( 12 ); ?> 

Outputs something like http://example.net/wp-content/uploads/filename

参考

• 'wp_get_attachment_url' フィルターを使ってこの関数の出力を変更できます。

• この関数は URI を「URL エンコード」しません。もし添付ファイルの名前に不正な文字が含まれるなら、有効な URL を得るためにこの関数の出力に rawurlencode 関数 を適用してください。下記のサンプルコードは、添付ファイルについてサイトのルートからの相対 URL を取得します：

$parsed = parse_url( wp_get_attachment_url( $attachment->ID ) );
$url    = dirname( $parsed [ 'path' ] ) . '/' . rawurlencode( basename( $parsed[ 'path' ] ) );

• 添付ファイル自体ではなく個別添付ファイルページの URI が欲しい場合は、get_attachment_link 関数を使ってください。

• 次の関数も参照してください: wp_insert_attachment(), wp_upload_dir()/en, wp_get_attachment_image_src()

変更履歴

2.1.0 : 新規導入

ソースファイル

wp_get_attachment_url() は wp-includes/post.php にあります。

関連資料

添付ファイル関数: get_children(), get attached media(), the_attachment_link(), get_attachment_link(), wp_get_attachment_link(), wp_get_attachment_image(), wp_get_attachment_image_src(), wp_get_attachment_url(), wp_get_attachment_thumb_file(), wp_get_attachment_thumb_url(), is_attachment(), wp_get_attachment_metadata()

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » Function Reference/wp_get_attachment_url （最新版との差分）