Yii Framework 使用 yiic 命令快速創建應用完整教程

Yii Framework 使用 yiic 命令快速創建應用完整教程

Yii 內建強大的命令列工具 yiic，能在幾秒鐘內生成標準目錄結構的 Web 應用骨架。本文以 Yii 1.1.8 為例，詳細記錄從進入框架目錄到在瀏覽器訪問生成項目的全過程，並補充國際化（i18n）訊息提取的實戰步驟。

一、查看 yiic 可用命令

cd /path/to/yii/framework
php yiic

輸出列出四大核心命令：message、migrate、shell、webapp。可通過 php yiic help <command> 查看具體用法。

二、創建 Web 應用骨架

php yiic webapp /absolute/path/to/new/app

執行後會在指定路徑生成完整目錄結構：

• assets/、css/、images/、index.php、index-test.php
• protected/：核心代碼目錄（models、views、controllers、config、components 等）
• themes/：主題目錄，預設包含 classic 風格

生成成功後，配置 Web 服務器指向項目根目錄，即可在瀏覽器看到 Yii 歡迎頁。

三、國際化（i18n）訊息提取與翻譯

1. 複製 framework/messages/config.php 到 protected/messages/config.php，修改 sourcePath、messagePath、languages 等配置。
2. 在視圖文件中用 Yii::t('category', 'message') 包裹需翻譯字串（如登錄頁的 username/password）。
3. 執行 php yiic message protected/messages/config.php，工具會掃描源碼並在 protected/messages/zh_cn/ 生成 PHP 陣列文件。
4. 編輯生成的文件填入中文翻譯，並在 main.php 設定 'language'=>'zh_cn', 'sourceLanguage'=>'en_us'。
5. 刷新頁面即可看到中文界面。

四、常見問題提示

• 確保 protected/runtime、assets 目錄可寫。
• 編碼統一使用 UTF-8，避免亂碼。
• 生產環境建議關閉 index-test.php 等測試入口。

掌握 yiic 可大幅提升項目初始化與維護效率，是 Yii 開發者必備技能。