使用 Composer 安裝 Yii2 框架（基礎版與進階版）完整指南

使用 Composer 安裝 Yii2 框架（基礎版與進階版）完整指南

Composer 是 PHP 依賴管理的標準工具，Yii2 官方推薦以此方式安裝，自動處理擴展包與版本鎖定。本文記錄從安裝 Composer 到創建項目的標準流程。

前置準備

1. 安裝 Composer（參考 官方文檔）。
2. 全域安裝 fxp/composer-asset-plugin（處理 Bower/NPM 資源包）：
   php composer.phar global require "fxp/composer-asset-plugin:^1.4.0"

創建項目

基礎應用模板（適合單入口項目）

php composer.phar create-project yiisoft/yii2-app-basic basic 2.0.4

進階應用模板（前後端分離、多環境）

php composer.phar create-project yiisoft/yii2-app-advanced advanced 2.0.4

過程中會提示輸入 GitHub 帳號密碼（用於提高 API 限額），輸入後繼續等待依賴下載完成。

安裝後初始化（進階模板）

cd advanced
php init  # 選擇 Development 或 Production 環境

初始化會生成 common/config/main-local.php、frontend/config/main-local.php 等本地配置文件，需根據實際情況填寫資料庫連接等敏感信息。

常見問題

• 若下載緩慢，可配置國內鏡像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 權限錯誤請確保 runtime、web/assets 目錄可寫。
• 版本號 2.0.4 可替換為 ~2.0.0 獲取最新穩定版。

Composer 安裝方式優勢在於依賴可追溯、易於團隊協作與 CI/CD 集成，建議所有新項目採用。