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

説明

基本構文

get_page_uri( int|WP_Post $page ): string|false

引数

• $page：ページIDまたはオブジェクト

戻り値

URIパス（例：parent/child）。

使い方（サンプル）

$uri = get_page_uri( 12 );

注意点

• 親ページを含むパスが返ります。

実務での使いどころ

• 固定ページの、階層を含む、パス（親/子）を取得するとき。
• get_page_by_path() に渡す、パスを作るとき。

よくあるミスと対処

• URLが、返ると考えている。この関数が返すのは、ドメインを含まない、階層のパス。URLには get_permalink() を使う。
• 存在しないページでは false が返る。確認せずに使う。

NG例

echo '<a href="' . get_page_uri( $id ) . '">ページ</a>'; // URLではなく、パス

OK例

$path = get_page_uri( $id );
$page = $path ? get_page_by_path( $path ) : null;
echo esc_url( get_permalink( $id ) );

使い分け早見表

関連項目

get_page_by_path()、get_permalink()

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