home_url()


WordPressのhome_url()関数は、サイトのホームURLを取得するために使用されます。この関数は、サイトのルートURLを返すため、リンクの生成やリダイレクトの設定に役立ちます。

構文

home_url( string $path = '', string $scheme = null );

引数の説明:

  • $path (string) — ホームURLに追加するパス。例えば、特定のページやカテゴリーへのリンクを生成する際に使用します。
  • $scheme (string) — URLのスキームを指定します。例えば、’http’、’https’、’relative’などを指定できます。

例1: ホームURLの取得

基本的な使い方で、サイトのホームURLを取得します。

<?php echo home_url(); ?>

例2: 特定のパスを追加したURLの取得

ホームURLに特定のパスを追加して、リンクを生成します。

<?php echo home_url('/about-us'); ?>

例3: HTTPSスキームを使用したURLの取得

HTTPSスキームを使用して、セキュアなホームURLを取得します。

<?php echo home_url('/', 'https'); ?>

例4: カテゴリーページへのリンク生成

特定のカテゴリーページへのリンクを生成します。

<?php echo home_url('/category/news'); ?>

例5: カスタム投稿タイプのアーカイブページへのリンク生成

カスタム投稿タイプのアーカイブページへのリンクを生成します。

<?php echo home_url('/post-type-archive'); ?>

例6: 相対URLの取得

相対URLを取得するために、スキームに’relative’を指定します。

<?php echo home_url('/', 'relative'); ?>

例7: クエリパラメータを追加したURLの取得

ホームURLにクエリパラメータを追加して、特定のページへのリンクを生成します。

<?php echo home_url('/?s=search-term'); ?>

注意点:

  • home_url()は、サイトのホームURLを返しますが、site_url()はWordPressのインストールディレクトリを返す点に注意してください。
  • スキームを指定しない場合、デフォルトで現在のリクエストに基づいたスキームが使用されます。

関連機能: