Extending / Bundled Extensions / Activation

Note: You are currently reading the documentation for Bolt 3.7. Looking for the documentation for Bolt 5.2 instead?

Once your Bundle can be autoloaded, then one more step is needed to enable Bolt to load them.

To activate a Bundle, you need to add an extensions key to either your .bolt.yml or .bolt.php file in the root of your project, with the values being the Bundles you want Bolt to load. If you don't have one of these files already then starting by creating an empty .bolt.yml is the easiest way to get started.

Updating .bolt.yml or .bolt.php¶

An example using .bolt.yml:

extensions:
    - BundleBaseNamespace\MyBundleExtension

To clarify, the value you put in the yml file is exactly what you would use to instantiate the class, so in code the above is equivalent to new \BundleBaseNamespace\MyBundleExtension()

.bolt.php allows for two different methods of loading, via strings:

<?php
return [
    'extensions' => [
        'BundleBaseNamespace\MyBundleExtension'
    ]
];

or via class instances:

<?php

use BundleBaseNamespace\MyBundleExtension;

return [
    'extensions' => [
        new MyBundleExtension()
    ]
];