Generating a New Bundle Skeleton

3.0 version
Maintained Unmaintained

Generating a New Bundle Skeleton


If your application is based on Symfony 2.x version, replace php bin/console with php app/console before executing any of the console commands included in this article.


The generate:bundle generates a new bundle structure and automatically activates it in the application.

By default the command is run in the interactive mode and asks questions to determine the bundle name, location, configuration format and default structure:

$ php bin/console generate:bundle

To deactivate the interactive mode, use the –no-interaction option but don’t forget to pass all needed options:

$ php bin/console generate:bundle --namespace=Acme/Bundle/BlogBundle --no-interaction


If the generate:bundle command returns an error about registering the bundle namespace in composer.json, add the following line to your composer.json file within the psr-4 section:

"Acme\\Bundle\\BlogBundle\\": "src/Acme/Bundle/BlogBundle"

(for example:

"autoload": {
    "psr-4": {
        "Acme\\Bundle\\BlogBundle\\": "src/Acme/Bundle/BlogBundle"
    "classmap": [ "app/AppKernel.php", "app/AppCache.php" ]

), then execute the following command to regenerate the autoload files:

$ composer dump-autoload

Available Options

Provide this option if you are creating a bundle that will be shared across several of your applications or if you are developing a third-party bundle. Don’t set this option if you are developing a bundle that will be used solely in your application (e.g. AppBundle).

The namespace of the bundle to create. The namespace should begin with a “vendor” name like your company name, your project name, or your client name, followed by one or more optional category sub-namespaces, and it should end with the bundle name itself (which must have Bundle as a suffix):

$ php bin/console generate:bundle --namespace=Acme/Bundle/BlogBundle

The optional bundle name. It must be a string ending with the Bundle suffix:

$ php bin/console generate:bundle --bundle-name=AcmeBlogBundle

The directory in which to store the bundle. By convention, the command detects and uses the application’s src/ folder:

$ php bin/console generate:bundle --dir=/var/www/myproject/src

allowed values: annotation|php|yml|xml default: annotation

Determine the format to use for the generated configuration files (like routing). By default, the command uses the annotation format (choosing the annotation format expects the SensioFrameworkExtraBundle to be installed):

$ php bin/console generate:bundle --format=annotation

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.