Yii 框架模塊綁定二級域名完整配置教程

Yii 框架模塊綁定二級域名完整配置教程

Yii 的 urlManager 支援基於域名的路由規則，可輕松實現模塊綁定二級域名。本文涵蓋配置、多控制器規則、本地 DNS 及 Apache 虛擬主機完整部署流程。

一、基礎配置（單模塊綁定）

'urlManager' => array(
    'urlFormat' => 'path',
    'showScriptName' => false,
    'urlSuffix' => '.html',
    'rules' => array(
        'https://test.jb51.net' => array('/blog', 'urlSuffix' => '', 'caseSensitive' => false),
    ),
),

• https://test.jb51.net：目標二級域名
• /blog：對應模塊 ID
• urlSuffix => ''：覆蓋全局後綴
• caseSensitive => false：不區分大小寫

二、多控制器/動作規則擴展

若模塊下有 CommentController，需額外添加規則：

'rules' => array(
    'https://test.jb51.net' => array('/blog', 'urlSuffix' => '', 'caseSensitive' => false),
    'https://test.jb51.net/comment-' => array('/blog/comment/', 'urlSuffix' => '.html', 'caseSensitive' => false),
),

訪問 https://test.jb51.net/comment-1.html 將路由到 BlogModule/CommentController。

三、本地開發環境部署（Windows + Apache）

1. Hosts 文件綁定域名

127.0.0.1 www.jb51.net test.jb51.net

路徑：C:\Windows\System32\drivers\etc\hosts（需管理員權限編輯）。

2. Apache 虛擬主機配置 (httpd.conf 或 httpd-vhosts.conf)

NameVirtualHost *:80

    ServerAdmin admin@jb51.net
    DocumentRoot "E:/wamp/www/k1029"
    ServerName test.jb51.net
    ErrorLog "logs/test.jb51.net-error_log"
    CustomLog "logs/test.jb51.net-access_log" common

多個二級域名重複添加 VirtualHost 塊即可。

四、生產環境注意事項

• DNS 解析：在域名服務商添加 A 記錄指向服務器 IP
• Nginx 配置：server_name test.jb51.net; 同理
• SSL 證書：泛域名證書可覆蓋所有二級域名

相關問答精選

Q: 二級域名綁定不生效怎麼辦？

A: 檢查主機商是否支援子域名綁定；確認程序 urlManager 規則正確；驗證 DNS 解析已生效。

Q: Yii 框架如何配置二級域名？

A: 參考本文 urlManager 規則寫法，關鍵在於域名作為規則鍵名。