Extending / Custom Bootstrapping
Note: You are currently reading the documentation for Bolt 3.2. Looking for the documentation for Bolt 3.6 instead?
Whilst Bolt is designed to be simple for anyone to install, its core functionality is also modular and easy to configure for developers who are comfortable making a few modifications to how Bolt is bootstrapped.
There are two ways your Bolt application is used, via web requests and via the
command line with
nut. Because there are two entry points, bootstrapping is
done in a common
One of the important functions of the bootstrap file is to read a loader
configuration file in the root directory of your project. By customising this
configuration file, you can modify things like paths, the application class to
use, and other services used by the application. This file can be either
By default, Bolt uses
.bolt.yml because who doesn't love YAML? But, for more
complex, or dynamic configuration options, you can use a PHP file instead,
The basics of configuring a Bolt application¶
The minimal requirement of configuring Bolt's bootstrap is path configuration.
Bolt needs to know these paths before configuration files like
read, in order to know where to find them.
A default Bolt install will have a
.bolt.yml file that would look similar to:
paths: web: public themebase: public/theme files: public/files view: public/bolt-public/view
The equivalent PHP file to the one above would look like:
<?php return [ 'paths' => [ 'web' => 'public', 'themebase' => 'public/theme', 'files' => 'public/files', 'view' => 'public/bolt-public/view', ] ];
Custom Application Class¶
The Application class can be changed here as well. This allows you to modify Bolt services or add your own.
In YAML, you can give the class name and we will create it for you. We will still apply any path customization afterwards as well.
application: My\Application paths: web: public #...
In PHP, you can give the class name...
<?php return [ 'application' => My\Application::class, 'paths' => [ 'web' => 'public' //... ] ];
For even more flexibly you can create the application yourself, or pull it in from another bootstrap file you have. It’s important to note here that if you give us an application object we'll assume it is ready to go. This means you'll need to apply any path customizations yourself. See the next section for an example.
<?php // Create the application. $app = new My\Application(); return [ 'application' => $app ]; // Alternatively, you can just return the pre-configured application object return $app;
Adding your own providers¶
If you don't want to extend Bolt\Application but still want to register your own services you can do that here. However, this can only be done with the PHP file version and you have to create the application yourself.
This gives a lot of scope to extend and augment core functionality, since you can either replace any core Bolt service, or as is described in the Silex TwigServiceProvider documentation, you can extend any existing Bolt service and add additional configurations to the service object.
<?php $resources = new Bolt\Configuration\Composer(__DIR__); $resources->setPath('web', 'public'); $app = new Bolt\Application(['resources' => $resources]); $app->initialize(); $app->register(new MyApp\Provider\ConsoleProvider()); $app->register(new MyApp\Provider\ControllerProvider()); $app->register(new MyApp\Provider\TwigProvider()); return $app;
You can make modifications to the services in the
$app variable within this
scope, such as replacing an existing service, or extend an existing one,
providing you do not attempt to either use the service, or access the
Mounting Bolt on an existing application¶
A lot of work has been done on the internals of Bolt which allow it now to run
as a self- contained
HTTPKernelInterface application without interfering with
any of the global namespace or constants. So if you use StackPHP (or similar)
you can mount Bolt onto a URL prefix as simply as this:
// Assuming this is in public/index.php and Bolt is located in vendor/bolt/bolt/ $map = [ '/another' => new AnotherApplication(), '/blog' => require __DIR__ . '/../vendor/bolt/bolt/app/bootstrap.php' ]; $app = (new Stack\Builder()) ->push('Stack\UrlMap', $map) ->resolve($app); Stack\run($app);
This means that you can, for instance, use Bolt to manage one specific part of a larger application set.