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

説明

基本構文

the_permalink( int|WP_Post $post = 0 ): void

引数

• $post：投稿IDまたはオブジェクト

戻り値

戻り値はありません（出力します）。

使い方（サンプル）

// ループ内で使用
the_permalink();

注意点

• URLを変数に入れたいときは get_permalink() を使います。
• 出力時にエスケープ処理（esc_url フィルター）が行われます。

実務での使いどころ

• ループの中で、投稿のURLを出力するとき（リンクの href など）。

よくあるミスと対処

• echo the_permalink() のように、echo を付けている。the_permalink() は、それ自体が出力する。
• 値として使いたいのに、これを使っている。値の取得は get_permalink()。
• ループの外で呼び、意図した投稿のURLにならない。

NG例

echo the_permalink(); // それ自体が出力する関数なので、echo は不要

OK例

<a href="<?php the_permalink(); ?>">記事へ</a>

使い分け早見表

関連項目

get_permalink()、esc_url()

公式リファレンス：the_permalink() | Function | WordPress Developer Resources