Symfonyでマルチドメイン・サブドメイン対応ルートを定義する方法を完全解説

Symfonyでマルチドメイン・サブドメイン対応ルートを定義する方法

先生と生徒の会話形式で理解しよう

生徒

「Symfonyで、ドメインごとに表示するページを変えることってできますか？」

先生

「できますよ。Symfonyのルーティング機能を使えば、マルチドメインやサブドメインに対応したページ分けができます。」

生徒

「ドメインって難しそうですが、初心者でも大丈夫ですか？」

先生

「大丈夫です。住所に例えながら、ゆっくり説明していきましょう。」

1. Symfonyのルーティングとは？

Symfonyのルーティングとは、「どのURLにアクセスされたら、どの処理を実行するか」を決める仕組みです。URLはインターネット上の住所のようなもので、Symfonyはその住所を見て、正しい部屋（コントローラー）へ案内してくれます。これにより、Symfonyアプリケーションは整理された構造を保つことができます。

プログラミング未経験の方は、URLを「郵便番号付きの住所」、ルーティングを「郵便物を仕分けする人」と考えると分かりやすいです。

2. ドメインとサブドメインの基本

ドメインとは「example.com」のようなWebサイトの名前です。一方、サブドメインは「admin.example.com」や「shop.example.com」のように、用途別に分けられた小さな住所です。

Symfonyでは、これらのドメインやサブドメインごとにルート（処理）を分けることができます。これをマルチドメイン対応やサブドメイン対応ルーティングと呼びます。

3. Symfonyでマルチドメイン対応が必要な理由

マルチドメイン対応を行うと、1つのSymfonyプロジェクトで複数のWebサイトを管理できます。例えば、「企業サイト」と「管理画面」を別ドメインで運用する場合でも、同じSymfonyアプリケーションで実現できます。

これにより、コードの再利用がしやすくなり、保守や修正も楽になります。初心者の方でも、仕組みを理解すれば安全に使えます。

4. ドメイン指定ルートの基本的な書き方

Symfonyでは、ルート定義時にhostという設定を使うことで、特定のドメイン専用のルートを作れます。


use Symfony\Component\Routing\Annotation\Route;

class HomeController
{
    #[Route('/', name: 'main_home', host: 'example.com')]
    public function index()
    {
        return 'メインサイトです';
    }
}

この設定では、「example.com」にアクセスしたときだけ、この処理が実行されます。他のドメインでは反応しません。

5. サブドメイン対応ルートを定義する方法

次に、サブドメイン対応です。サブドメインは変数として扱うこともできます。


#[Route('/', name: 'sub_home', host: '{subdomain}.example.com')]
public function subDomain($subdomain)
{
    return $subdomain . '用のページです';
}

この例では、「admin.example.com」や「shop.example.com」にアクセスすると、それぞれのサブドメイン名が表示されます。これは、マンションの部屋番号を自動で読み取るようなイメージです。

6. 複数ドメインを1つのルートで扱う方法

Symfonyでは、複数ドメインをまとめて扱うことも可能です。条件を使って処理を分けることで、柔軟な設計ができます。


#[Route('/', name: 'multi_domain', host: '{domain}')]
public function multiDomain($domain)
{
    if ($domain === 'example.com') {
        return 'example.com用ページ';
    }
    return 'その他のドメイン用ページ';
}

これにより、ドメインごとに表示内容を切り替えられます。初心者の方でも、if文が分かれば理解しやすい仕組みです。

7. YAMLで定義するマルチドメインルーティング

Symfonyでは、PHPだけでなくYAML形式でもルーティングを定義できます。設定ファイルで管理したい場合に便利です。


main_home:
    path: /
    host: example.com
    controller: App\Controller\HomeController::index

YAMLは設定専用の書き方で、文章のように読めるのが特徴です。プログラミング未経験の方でも、構造を理解しやすい形式です。

8. マルチドメイン設計でよくある注意点

マルチドメイン対応では、キャッシュやCookieの扱いに注意が必要です。特にログイン機能がある場合、ドメインが違うと情報を共有できないことがあります。

Symfonyのルーティング自体はシンプルですが、設計段階で「どのドメインで、誰が、何を見るか」を整理することが大切です。これは家の間取りを考えるのと同じで、最初に決めておくと後が楽になります。

公的機関での指導実績【Symfony大規模設計実践セミナー】

エンタープライズSymfony実践講座：大規模DX基盤を支える疎結合設計とドメイン駆動開発

#商用設計 #APIアーキテクチャ #市場価値最大化

ハローワーク職業訓練講師の実績を持つプロが監修。商用PHP開発の「現場の作法」を完全伝授。

「大規模システムの秩序」を設計する。SymfonyでエンタープライズLOD（設計の質）を極める。

本講座では、単なるWeb機能の構築ではなく、「再利用性とテスト容易性を追求した疎結合設計」という高度な技術を学びます。世界標準の堅牢性を誇るSymfonyを通じて、大規模開発やマイクロサービス化で必須となるDI（依存性の注入）やイベント駆動設計を最短距離で身につけます。

具体的なワークショップ内容と環境

【つくるもの】
エンタープライズ環境の標準となる「疎結合なバックエンド基盤」を構築します。Service Containerの高度な設定、Doctrine ORMによる複雑なデータマッピング、Bundle構造の理解など、「数年先もメンテナンス可能な商用コード」をゼロから体験してください。

【開発環境】
高度なリファクタリングを可能にするPHPStormの機能をフル活用。Docker環境での開発はもちろん、静的解析ツール（PHPStan）やCI/CDを意識した自動テスト環境まで、大規模プロジェクトの標準フローを再現します。