# Bundle(綑綁包)

捆綁包類似於其他軟體中的外掛程式(plugin)但是比他更好。

Symfony框架的核心功能是透過bundles（FrameworkBundle、SecurityBundle、DebugBundle 等）實現的。
也可以透過[第三方](https://github.com/search?q=topic%3Asymfony-bundle&type=Repositories)bundle在你的應用程序中添加新功能。

在你的應用程式中，必須在```config/bundles.php```文件中設置，才能為每個環境所啟用：

// config/bundles.php
return [
    // 'all' means that the bundle is enabled for any Symfony environment
    Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
    Symfony\Bundle\SecurityBundle\SecurityBundle::class => ['all' => true],
    Symfony\Bundle\TwigBundle\TwigBundle::class => ['all' => true],
    Symfony\Bundle\MonologBundle\MonologBundle::class => ['all' => true],
    Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle::class => ['all' => true],
    Doctrine\Bundle\DoctrineBundle\DoctrineBundle::class => ['all' => true],
    Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true],
    // this bundle is enabled only in 'dev' and 'test', so you can't use it in 'prod'
    Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true, 'test' => true],
];

:::success
在symfony預設的情話下會使用[symfony flex](https://symfony.com/doc/4.4/setup.html#symfony-flex)，安裝/刪除bundle時會自動啟用/禁用bundle，因此您無需查看或編輯此```bundles.php```文件。
:::

創建捆綁包
===
創建並啟用一個bundle，只需要幾個步驟。
新bundle 稱為 ```AcmeTestBundle```，其中的```Acme```部分是一個範例名稱，應替換為代表你的應用程式的某個“供應商(vendor)”名稱（例如，某些名為```ABC```的公司bundle ABCTestBundle）。

首先創建一個```src/Acme/TestBundle/```目錄並添加一個新文件```AcmeTestBundle.php```：

// src/Acme/TestBundle/AcmeTestBundle.php
namespace App\Acme\TestBundle;

use Symfony\Component\HttpKernel\Bundle\Bundle;

class AcmeTestBundle extends Bundle
{
}

:::success
AcmeTestBundle 的名稱遵循標準的 Bundle[命名規則](https://symfony.com/doc/4.4/bundles/best_practices.html#bundles-naming-conventions)。您還可以選擇通過命名此類 TestBundle（並命名文件```TestBundle.php```）來將bundle的名稱縮短為簡單的 ```TestBundle ```。
:::

這個empty class是創建新bundle所需的唯一部分。
儘管通常為empty，但該class功能強大，可用於自定義bundle的行為。

現在已經創建了bundle，啟用它：

// config/bundles.php
return [
    // ...
    App\Acme\TestBundle\AcmeTestBundle::class => ['all' => true],
];

雖然它還沒有做任何事情，但 AcmeTestBundle 現在已經可以使用了。

## bundle 目錄結構
bundle的目錄結構旨在幫助保持所有 Symfony bundle之間的code一致。

它遵循一些準則，但可以根據需要靈活調整：

- ```Controller/```
- 包含bundle的控制器（例如RandomController.php）。

- ```DependencyInjection/```
- 持有某些依賴注入擴展類別，這些類別可以導入服務配置、註冊編譯器傳遞或更多資訊（此目錄不是必需的）。

- ```Resources/config/```
- houses配置，包括路由配置（例如```routing.yaml```）。

- ```Resources/views/```
- 按控制器名稱保存（例如```Random/index.html.twig```）組成的模板。

- ```Resources/public/```
- 包含網絡資源（圖像、stylegheets等），且透過命令```assets:install‵```來link或是複製到```public/```目錄中。

- ```Tests/```
- 保存bundle的所有測試。

一個bundle可以根據實現的特性來決定大小。
只包含您需要的文件，不包含其他任何文件。

可以透過學習如何將object永久保存到資料庫、創建和驗證表單、為您的應用程式創建翻譯、編寫測試等等。

上述這些在bundle中都有自己的位置和角色。

官方所提供的常用[bundle](https://symfony.com/bundles)
===