Windows 環境下 Yii Framework 應用建立與常見錯誤排除

Windows 環境下 Yii Framework 應用建立與常見錯誤排除

在 Windows (WAMP) 環境下使用 Yii 1.x 的 yiic 指令建立 Web 應用時，常因 PHP 路徑未加入環境變數導致執行失敗。本文記錄完整操作步驟與錯誤修正方法。

環境前提

• 作業系統：Windows 7
• 整合環境：WAMP
• Yii 版本：1.x (使用 yiic 指令)

標準建立應用流程

1. 以系統管理員身分執行 cmd.exe。
2. 切換至 Yii framework 目錄：

   D:
   cd D:\wamp\www\yii\framework

3. 測試 yiic 指令：

   yiic

   若顯示幫助資訊，代表指令可用。
4. 建立應用（例如 newstar）：

   yiic webapp ../newstar

常見錯誤：'php.exe' 不是內部或外部命令

錯誤現象：執行 yiic 顯示 'php.exe' 不是內部或外部命令，也不是可執行的程式或批次檔。

成因：WAMP 安裝時未將 PHP 目錄加入系統 PATH 環境變數，yiic.bat 找不到 php.exe。

修正方法：編輯 yiic.bat 指定 PHP 絕對路徑

1. 開啟 D:\wamp\www\yii\framework\yiic.bat（記事本）。
2. 找到以下行：

   if "%PHP_COMMAND%" == "" set PHP_COMMAND=php.exe

3. 修改為你的 PHP 實際安裝路徑：

   if "%PHP_COMMAND%" == "" set PHP_COMMAND=D:\wamp\bin\php\php5.3.10\php.exe

4. 儲存並重新執行 yiic webapp ../newstar。

替代方案：將 PHP 加入系統環境變數（一勞永逸）

1. 右鍵「電腦」→「內容」→「進階系統設定」→「環境變數」。
2. 系統變數區找到 Path，編輯，新增 D:\wamp\bin\php\php5.3.10。
3. 重開 cmd 視窗，php -v 驗證。

驗證應用建立成功

瀏覽器訪問 https://localhost/yii/newstar/，若顯示 Yii 歡迎頁面，代表應用建立成功。

補充：Yii 2.x 現代化建立方式

Yii 2 採用 Composer 管理，不再使用 yiic：

composer create-project --prefer-dist yiisoft/yii2-app-basic newstar

建議新專案直接使用 Yii 2，享受現代 PHP 開發體驗（命名空間、Composer、PSR-4、PHP 7/8 支援）。