WordPressのhome_url()関数リファレンス

2025/08/06
REFERENCE
WordPressの関数
0comments
144views
約5分で読めます

WordPressのテーマ開発において、サイト内のページへのリンクを生成するために使用されるhome_url()関数の完全リファレンスです。

関数の概要

定義

home_url()は、WordPressサイトのホームURLを取得する関数です。

目的

サイト内のページへの絶対URLを動的に生成
環境に依存しないリンクの作成
WordPressの設定に基づいた正しいURLの出力

基本動作

WordPressの管理画面「設定」→「一般」で設定されている「サイトアドレス（URL）」を基準として、指定されたパスを結合したURLを返します。

基本構文

home_url( $path, $scheme );

home_url( $path, $scheme );

PHP

パラメータ

$path（文字列、オプション）

デフォルト値： ''（空文字列）
説明： ホームURLに追加するパス
例： 'about', 'contact', 'category/news'

$scheme（文字列、オプション）

デフォルト値： null
説明： URLのプロトコルを指定
指定可能な値：
- 'http' – HTTPプロトコルを強制
- 'https' – HTTPSプロトコルを強制
- 'relative' – プロトコル相対URL（//example.com/path/）
- null – サイトの設定に従う

明確な意図がない限りプロトコルは指定せず、Webサイトのプロトコルに従ってください。

戻り値

データ型： 文字列（string）

内容： 完全なURL文字列

例：

// パラメータなしの場合
home_url(); // "https://example.com"

// パスを指定した場合
home_url('about'); // "https://example.com/about"

// プロトコルを指定した場合
home_url('about', 'http'); // "http://example.com/about"

// パラメータなしの場合
home_url(); // "https://example.com"

// パスを指定した場合
home_url('about'); // "https://example.com/about"

// プロトコルを指定した場合
home_url('about', 'http'); // "http://example.com/about"

PHP

使用例

基本的な使用例

ホームページのURL

<?php echo home_url(); ?>
// 出力: https://example.com

<?php echo home_url(); ?>
// 出力: https://example.com

PHP

特定のページのURL

<?php echo home_url('about'); ?>
// 出力: https://example.com/about

<?php echo home_url('about'); ?>
// 出力: https://example.com/about

PHP

カテゴリーページのURL

<?php echo home_url('category/news'); ?>
// 出力: https://example.com/category/news

<?php echo home_url('category/news'); ?>
// 出力: https://example.com/category/news

PHP

プロトコル指定の使用例

明確な意図がない限りプロトコルは指定せず、Webサイトのプロトコルに従ってください。

HTTPを強制

<?php echo home_url('about', 'http'); ?>
// 出力: http://example.com/about

<?php echo home_url('about', 'http'); ?>
// 出力: http://example.com/about

PHP

HTTPSを強制

<?php echo home_url('about', 'https'); ?>
// 出力: https://example.com/about

<?php echo home_url('about', 'https'); ?>
// 出力: https://example.com/about

PHP

プロトコル相対URL

<?php echo home_url('about', 'relative'); ?>
// 出力: //example.com/about

<?php echo home_url('about', 'relative'); ?>
// 出力: //example.com/about

PHP

HTML内での使用例

ナビゲーションリンク

<nav>
    <ul>
        <li><a href="<?php echo home_url(); ?>">ホーム</a></li>
        <li><a href="<?php echo home_url('about'); ?>">会社概要</a></li>
        <li><a href="<?php echo home_url('contact'); ?>">お問い合わせ</a></li>
    </ul>
</nav>

<nav>
    <ul>
        <li><a href="<?php echo home_url(); ?>">ホーム</a></li>
        <li><a href="<?php echo home_url('about'); ?>">会社概要</a></li>
        <li><a href="<?php echo home_url('contact'); ?>">お問い合わせ</a></li>
    </ul>
</nav>

PHP

フォームのaction属性

<form action="<?php echo home_url('search'); ?>" method="get">
    <input type="text" name="s" placeholder="検索...">
    <button type="submit">検索</button>
</form>

<form action="<?php echo home_url('search'); ?>" method="get">
    <input type="text" name="s" placeholder="検索...">
    <button type="submit">検索</button>
</form>

PHP

注意事項

echoの必要性

❌ 間違った使用法

<a href="<?php home_url('about'); ?>">リンク</a>

<a href="<?php home_url('about'); ?>">リンク</a>

PHP

✅ 正しい使用法

<a href="<?php echo home_url('about'); ?>">リンク</a>

<a href="<?php echo home_url('about'); ?>">リンク</a>

PHP

理由： home_url()は値を返すだけで、出力はしません。出力するにはechoが必要です。

まとめ

home_url()関数は、WordPressテーマ開発において環境に依存しない信頼性の高いURL生成を可能にする重要な関数です。

基本的な使用パターン

<?php echo home_url(); ?>           // ホームページ
<?php echo home_url('about'); ?>    // 特定のページ

<?php echo home_url(); ?>           // ホームページ
<?php echo home_url('about'); ?>    // 特定のページ

PHP

重要なポイント

出力にはechoが必要
WordPressの設定に基づいて動的にURL生成
環境の違いを自動的に吸収

この関数が使われている投稿

この記事の評価をお願いします

評価をすると「既読」となり、まだ読んでいない記事を区別できます。

この投稿をシェアする

コメントを残す

STAY CONNECTED

現役のフリーランスエンジニアがWordPressによるWebサイト構築を基礎から実践テクニックまで徹底解説します。

たくさんの方がフォローしてくれています。あなたもぜひ、情報を受け取ってください。

STORY｜ストーリー

WordPressを効率よく確実に学ぶためには、学習の順序が大切です。知識が自然に積み上がるよう、学習ステップに沿って記事を順番に並べています。

学習ストーリー第40話まで掲載中

全ストーリーを見る

PRACTICE｜カフェ編

カフェを題材にした本格的なサイト構築を公開中。実践を通してサイトの構築方法を学べます。

サンプルサイト：WPCafe

実践ストーリー第11話まで掲載中