remove.rst

.. index::
    single: Bundle; Removing AcmeDemoBundle

How to remove the AcmeDemoBundle

The Symfony2 Standard Edition comes with a complete demo that lives inside a bundle called AcmeDemoBundle. It is a great boilerplate to refer to while starting a project, but you'll probably want to eventually remove it.

Tip

This article uses the AcmeDemoBundle as an example, but you can use these steps to remove any bundle.

1. Unregister the bundle in the AppKernel

To disconnect the bundle from the framework, you should remove the bundle from the Appkernel::registerBundles() method. The bundle is normally found in the $bundles array but the AcmeDemoBundle is only registered in a development environment and you can find him in the if statement after:

// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(...);

        if (in_array($this->getEnvironment(), array('dev', 'test'))) {
            // comment or remove this line:
            // $bundles[] = new Acme\DemoBundle\AcmeDemoBundle();
            // ...
        }
    }
}

2. Remove bundle configuration

Now that Symfony doesn't know about the bundle, you need to remove any configuration and routing configuration inside the app/config directory that refers to the bundle.

2.1 Remove bundle routing

The routing for the AcmeDemoBundle can be found in app/config/routing_dev.yml. Remove the _acme_demo entry at the bottom of this file.

2.2 Remove bundle configuration

Some bundles contain configuration in one of the app/config/config*.yml files. Be sure to remove the related configuration from these files. You can quickly spot bundle configuration by looking at a acme_demo (or whatever the name of the bundle is, e.g. fos_user for the FOSUserBundle) string in the configuration files.

The AcmeDemoBundle doesn't have configuration. However, the bundle is used in the configuration for the app/config/security.yml file. You can use it as a boilerplate for your own security, but you can also remove everything: it doesn't matter to Symfony if you remove it or not.

3. Remove the bundle from the Filesystem

Now you have removed every reference to the bundle in your application, you should remove the bundle from the filesystem. The bundle is located in the src/Acme/DemoBundle directory. You should remove this directory and you can remove the Acme directory as well.

Tip

If you don't know the location of a bundle, you can use the :method:`Symfony\\Bundle\\FrameworkBundle\\Bundle\\Bundle::getPath` method to get the path of the bundle:

echo $this->container->get('kernel')->getBundle('AcmeDemoBundle')->getPath();

4. Remove integration in other bundles

Note

This doesn't apply to the AcmeDemoBundle - no other bundles depend on it, so you can skip this step.

Some bundles rely on other bundles, if you remove one of the two, the other will probably not work. Be sure that no other bundles, third party or self-made, rely on the bundle you are about to remove.

Tip

If one bundle relies on another, in most it means that it uses some services from the bundle. Searching for a acme_demo string may help you spot them.

Tip

If a third party bundle relies on another bundle, you can find that bundle mentioned in the composer.json file included in the bundle directory.