Symfony 安裝第三方 Bundle 完整流程：Composer、Kernel 註冊與設定

三步驟標準流程

1. Composer 安裝：下載程式碼至 vendor/ 並更新 composer.json/composer.lock。
2. Kernel 註冊：在 AppKernel.php 啟用 Bundle。
3. 設定檔調整：依 Bundle 需求修改 config.yml 等。

步驟一：Composer 安裝

尋找套件名稱

• 查看 Bundle README 或 Packagist 搜尋。
• 例如：codeguy/upload、doctrine/doctrine-fixtures-bundle。

安裝指令

# 自動選擇相容版本
composer require vendor/package

# 指定版本
composer require vendor/package:^1.2

# 開發環境專用
composer require --dev vendor/package

步驟二：註冊 Bundle

<?php // app/AppKernel.php
public function registerBundles()
{
    $bundles = [
        // Symfony 核心 Bundles...
        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
        // ...

        // 第三方 Bundles
        new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(),
        new Stof\DoctrineExtensionsBundle\StofDoctrineExtensionsBundle(),
        // 新安裝的 Bundle 加在這裡
    ];

    if (in_array($this->getEnvironment(), ['dev', 'test'])) {
        $bundles[] = new Symfony\Bundle\DebugBundle\DebugBundle();
        // ...
    }
    return $bundles;
}

注意：部分 Bundle 需區分環境（如僅 dev/test 載入），請參考其文件。

步驟三：設定 Bundle

查看可用設定

# 列出所有 Bundle 設定參考
php app/console config:dump-reference

# 查看特定 Bundle（如 TwigBundle）
php app/console config:dump-reference TwigBundle

輸出範例（TwigBundle）

# Default configuration for "TwigBundle"
twig:
    exception_controller: 'twig.controller.exception:showAction'
    form_themes: ['form_div_layout.html.twig']
    globals:
        site_name: 'My Site'
    cache: '%kernel.cache_dir%/twig'
    debug: '%kernel.debug%'
    # ...

實際覆寫設定（config.yml）

# app/config/config.yml
stof_doctrine_extensions:
    orm:
        default:
            timestampable: true
            sluggable: true
            softdeleteable: true

常見 Bundle 安裝實例

驗證安裝成功

php app/console debug:container --parameter=kernel.bundles
# 或
php app/console debug:config VendorBundleName

避坑指南

• 安裝後 務必清除快取：php app/console cache:clear。
• 版本衝突時，查看 composer.json 的 require 區塊，手動調整版本約束後 composer update。
• 部分舊 Bundle 不支援 Symfony 4/5/6 Flex 結構，需確認相容性。

遵循此標準流程，即能安全、可維護地擴展 Symfony 專案功能。