Yii 框架入門指南：安裝配置與首個應用創建全流程

Yii 簡介

Yii 是一個基於組件、高性能的 PHP 框架，專為大型 Web 應用開發設計。它採用嚴格的 OOP 模式，提供 MVC、DAO/ActiveRecord、緩存、RBAC、Web Service、國際化（I18N/L10N）等豐富功能，被公認為最高效的 PHP 框架之一。通過命令行工具 yiic 可快速生成應用骨架，讓開發者專注於業務邏輯。

環境需求

• Web 服務器（Apache / Nginx）
• PHP 5.1.0+
• PDO 擴展及對應數據庫驅動

安裝步驟

1. 從 官網 下載框架壓縮包。
2. 解壓至 Web 服務器可訪問目錄（如 /var/www/html/yii）。
3. 訪問檢測工具驗證環境：https://yourhost/path/to/yii/requirements/index.php。只要核心項目顯示 Passed 且結論為「滿足最低要求」即可。

創建首個應用

# 進入 framework 目錄
cd /var/www/html/yii/framework

# 生成應用骨架至 /var/www/html/testdrive
./yiic webapp ../../testdrive

生成的目錄結構包含入口腳本、配置文件、控制器、模型、視圖、運行時目錄等，開箱即用。

訪問驗證

瀏覽器訪問 https://hostname/testdrive/index.php，即可看到包含首頁、聯系頁、登錄頁的默認應用。

核心配置：隱藏 index.php 與 URL 美化

1. 啟用 Apache mod_rewrite

# httpd.conf 中取消註釋
LoadModule rewrite_module modules/mod_rewrite.so
# 確保目錄允許覆蓋
AllowOverride All

2. 配置 urlManager（protected/config/main.php）

'components' => array(
    'urlManager' => array(
        'urlFormat' => 'path',
        'showScriptName' => false, // 關鍵：隱藏 index.php
        'rules' => array(
            'sites' => 'site/index',
        ),
    ),
),

3. 配置 .htaccess（Apache）

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

4. Nginx 配置示例

server {
    root /www/mysite/htdocs;
    index index.php;
    location / { try_files $uri $uri/ /index.php?$args; }
    location ~ ^/(protected|framework|themes/\w+/views) { deny all; }
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

建議

在 php.ini 中設置 cgi.fix_pathinfo=0 可提升安全性與性能。完成上述步驟，Yii 基礎環境即搭建完畢，可開始業務開發。