Symfony2 安裝第三方 Bundle 完整流程指南

三步驟安裝法

1. 新增 Composer 依賴

於專案根目錄執行：

composer require vendor/package-name

指定版本：composer require vendor/package-name:^1.2。Composer 會自動更新 composer.json 並下載套件至 vendor/。

2. 註冊 Bundle

編輯 app/AppKernel.php，於 registerBundles() 陣列加入：

public function registerBundles()
{
    $bundles = array(
        // ...
        new Vendor\PackageBundle\VendorPackageBundle(),
    );
    // ...
}

3. 設定 Bundle（如需）

部分 Bundle 需在 app/config/config.yml 加入設定。可用指令查看預設設定結構：

php app/console config:dump-reference VendorPackageBundle

實例：安裝 CodeGuy/Upload 圖片上傳 Bundle

composer require codeguy/upload

註冊：

new CodeGuy\UploadBundle\CodeGuyUploadBundle(),

常見問題

• 版本衝突：若 composer require 失敗，嘗試手動編輯 composer.json 指定相容版本，再執行 composer update。
• 自動載入失效：確認 vendor/autoload.php 已包含，且 Bundle 命名空間符合 PSR-4/PSR-0。
• 快取未清：安裝後執行 php app/console cache:clear --env=prod（或 dev）。

最佳實踐

1. 優先選擇有持續維護、文件完善、星數較高的 Bundle。
2. 將 composer.lock 納入版控，確保團隊/部署環境版本一致。
3. 僅在 dev 環境需求的 Bundle（如除錯工具）加在 require-dev 區塊。