Symfony - 捆绑包 (kuǎnbǎng bāo)



Symfony 捆绑包是一个以特定结构组织的文件和文件夹集合。捆绑包的设计使其能够在多个应用程序中重复使用。主应用程序本身也被打包成一个捆绑包,通常称为AppBundle

捆绑包可以针对特定应用程序进行打包,例如 AdminBundle(管理部分)、BlogBundle(网站博客)等。此类捆绑包不能在应用程序之间共享。相反,我们可以将应用程序的某些部分(例如博客)建模为通用捆绑包,这样我们就可以简单地将捆绑包从一个应用程序复制到另一个应用程序以重用博客功能。

捆绑包的结构

捆绑包的基本结构如下。

  • Controller − 所有控制器都需要放置在此处。

  • DependencyInjection − 所有与依赖注入相关的代码和配置都需要放置在此处。

  • Resources/config − 捆绑包相关的配置放置在此处。

  • Resources/view − 捆绑包相关的视图模板放置在此处。

  • Resources/public − 捆绑包相关的样式表、JavaScript、图像等放置在此处。

  • Tests − 捆绑包相关的单元测试文件放置在此处。

创建捆绑包

让我们在 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 :).  
广告 (guǎnggào)