1-33

Symfony2 – Franz Jordán 2011
Start by creating a src/Acme/TestBundle/ directory and adding a new file
calledAcmeTestBundle.php:
// src/Acme/TestBundle/AcmeTestBundle.php
namespace Acme\TestBundle;
use Symfony\Component\HttpKernel\Bundle\Bundle;
class AcmeTestBundle extends Bundle
{
}
The name AcmeTestBundle follows the standard Bundle naming conventions. You could also
choose to shorten the name of the bundle to simply TestBundle by naming this
class TestBundle (and naming the file TestBundle.php).
This empty class is the only piece you need to create the new bundle. Though commonly empty,
this class is powerful and can be used to customize the behavior of the bundle.
Now that you've created the bundle, enable it via the AppKernel class:
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
}
// register your bundles
new Acme\TestBundle\AcmeTestBundle(),
);
// ...
return $bundles;
And while it doesn't do anything yet, AcmeTestBundle is now ready to be used.
And as easy as this is, Symfony also provides a command-line interface for generating a basic
bundle skeleton:
php app/console generate:bundle --namespace=Acme/TestBundle
The bundle skeleton generates with a basic controller, template and routing resource that can be
customized. You'll learn more about Symfony2's command-line tools later.
Whenever creating a new bundle or using a third-party bundle, always make sure the bundle has
been enabled in registerBundles(). When using thegenerate:bundle command, this is
done for you.
Bundle Directory Structure
The directory structure of a bundle is simple and flexible. By default, the bundle system follows
a set of conventions that help to keep code consistent between all Symfony2 bundles. Take a
look atAcmeHelloBundle, as it contains some of the most common elements of a bundle:
Controller/ contains the controllers of the bundle (e.g. HelloController.php);
Resources/config/ houses configuration, including routing configuration
(e.g.routing.yml);
Resources/views/ holds templates organized by controller name
(e.g.Hello/index.html.twig);
41