Symfony - Bundles
Symfony Bundle 是按特定结构组织的文件和文件夹的集合。这些 Bundle 的建模方式使其可以在多个应用程序中重复使用。主应用程序本身打包为一个 Bundle,通常称为 AppBundle。
Bundle 可以针对特定应用程序进行打包,例如 AdminBundle(管理部分)、BlogBundle(站点博客)等。此类 Bundle 不能在应用程序之间共享。相反,我们可以将应用程序的某个部分(例如博客)建模为通用 Bundle,这样我们就可以简单地将 Bundle 从一个应用程序复制到另一个应用程序以重用博客功能。
Bundle 的结构
Bundle 的基本结构如下。
控制器 −所有的控制器都需要放在这里。
DependencyInjection − 所有的依赖注入相关的代码和配置都需要放在这里。
Resources/config − Bundle相关的配置放在这里。
Resources/view − Bundle相关的视图模板放在这里。
Resources/public − Bundle相关的样式表、JavaScript、图像等都放在这里。
测试 −捆绑包相关的单元测试文件放在这里。
创建捆绑包
让我们在 HelloWorld 应用程序中创建一个简单的捆绑包 TutorialspointDemoBundle。
步骤 1 − 选择一个命名空间。捆绑包的命名空间应包括供应商名称和捆绑包名称。在我们的例子中,它是 Tutorialspoint\DemoBundle。
步骤 2 − 通过扩展 Bundle 类创建一个空类 TutorialspointDemoBundle,并将其放在 src/Tutorialspoint/DemoBundle 下。
namespace Tutorialspoint\DemoBundle; use Symfony\Component\HttpKernel\Bundle\Bundle; class TutorialspointDemoBundle extends Bundle { }
步骤 3 − 在 AppKernel 类中将该类注册到应用程序支持的捆绑包列表中。
public function registerBundles() { $bundles = array( // ... // register your bundle new Tutorialspoint\DemoBundle\TutorialspointDemoBundle(), ); return $bundles; }
这就是创建一个空包所需的全部内容,其他所有概念与应用程序相同。Symfony 还提供了一个控制台命令 generate:bundle 来简化创建新包的过程,如下所示。
php bin/console generate:bundle --namespace = Tutorialspoint/DemoBundle
结果
Welcome to the Symfony bundle generator! Are you planning on sharing this bundle across multiple applications? [no]: no Your application code must be written in bundles. This command helps you generate them easily. Give your bundle a descriptive name, like BlogBundle. Bundle name [Tutorialspoint/DemoBundle]: In your code, a bundle is often referenced by its name. It can be the concatenation of all namespace parts but it's really up to you to come up with a unique name (a good practice is to start with the vendor name). Based on the namespace, we suggest TutorialspointDemoBundle. Bundle name [TutorialspointDemoBundle]: Bundles are usually generated into the src/ directory. Unless you're doing something custom, hit enter to keep this default! Target Directory [src/]: What format do you want to use for your generated configuration? Configuration format (annotation, yml, xml, php) [annotation]: Bundle generation > Generating a sample bundle skeleton into app/../src/Tutorialspoint/DemoBundle created ./app/../src/Tutorialspoint/DemoBundle/ created ./app/../src/Tutorialspoint/DemoBundle/TutorialspointDemoBundle.php created ./app/../src/Tutorialspoint/DemoBundle/Controller/ created ./app/../src/Tutorialspoint/DemoBundle/Controller/DefaultController.php created ./app/../tests/TutorialspointDemoBundle/Controller/ created ./app/../tests/TutorialspointDemoBundle/Controller/DefaultControllerTest.php created ./app/../src/Tutorialspoint/DemoBundle/Resources/views/Default/ created ./app/../src/Tutorialspoint/DemoBundle/Resources/views/Default/index.html.twig created ./app/../src/Tutorialspoint/DemoBundle/Resources/config/ created ./app/../src/Tutorialspoint/DemoBundle/Resources/config/services.yml > Checking that the bundle is autoloaded > Enabling the bundle inside app/AppKernel.php updated ./app/AppKernel.php > Importing the bundle's routes from the app/config/routing.yml file updated ./app/config/routing.yml > Importing the bundle's services.yml from the app/config/config.yml file updated ./app/config/config.yml Everything is OK! Now get to work :).