WordPress functions.php

サイトのトップ（設定の「サイトアドレス (URL)」）に、パスを付けた URL を作ります。テーマやプラグインでサイトの中のリンクを作るときに使います。

書き方

home_url( string $path = '', string|null $scheme = null ): string

• $path（省略できる）：後ろに付けるパス（/contact/ など）
• $scheme（省略できる）：https・http・relative など。ふつうは省略します。

使い方の例

<a href="<?php echo esc_url( home_url( '/' ) ); ?>">トップへ</a>
<a href="<?php echo esc_url( home_url( '/service/' ) ); ?>">サービス</a>

// URL がこのサイトの中かを見る
$is_inside = wp_parse_url( $url, PHP_URL_HOST ) === wp_parse_url( home_url(), PHP_URL_HOST );

よくある間違い

• site_url() と取り違える：site_url() は WordPress を置いた場所（設定の「WordPress アドレス (URL)」）です。WordPress をサブフォルダーに置いているときは 2 つが違います。訪問者向けのリンクは home_url() です。
• テーマのファイルに使う：テーマの CSS・画像の URL は get_template_directory_uri()（子テーマなら get_stylesheet_directory_uri()）です。
• ドメインを書き込む：https://example.com/ を直に書くと、作業環境や移転のあとに違うサイトへ飛びます。home_url() で作ります。
• 出力するときは esc_url() を通します。

関連する関数

• site_url()：WordPress を置いた場所の URL
• admin_url()：管理画面の URL
• get_template_directory_uri()：テーマのフォルダーの URL
• add_query_arg()：URL にパラメーターを足す

逆引きリファレンスの一覧へ