Class BaseApplication
Base class for full-stack applications
This class serves as a base class for applications that are using CakePHP as a full stack framework. If you are only using the Http or Console libraries you should implement the relevant interfaces directly.
The application class is responsible for bootstrapping the application, and ensuring that middleware is attached. It is also invoked as the last piece of middleware, and delegates request/response handling to the correct controller.
Property Summary
-
$_eventClass protected
stringDefault class name for new event objects.
-
$_eventManager protected
Cake\Event\EventManagerInterfaceInstance of the Cake\Event\EventManager this object is using to dispatch inner events.
-
$configDir protected
string -
$controllerFactory protected
Cake\Http\ControllerFactoryInterface|nullController factory
-
$plugins protected
Cake\Core\PluginCollectionPlugin Collection
Method Summary
-
__construct() public
Constructor
-
addOptionalPlugin() public
Add an optional plugin
-
addPlugin() public
Add a plugin to the loaded plugin set.
-
bootstrap() public
Load all the application configuration and bootstrap logic.
-
console() public
Define the console commands for an application.
-
dispatchEvent() public
Wrapper for creating and dispatching events.
-
getEventManager() public
Returns the Cake\Event\EventManager manager instance for this object.
-
getPlugins() public
Get the plugin collection in use.
-
handle() public
Invoke the application.
-
middleware() abstract public
Define the HTTP middleware layers for an application.
-
pluginBootstrap() public
Run bootstrap logic for loaded plugins.
-
pluginConsole() public
Run console hooks for plugins
-
pluginMiddleware() public
Run middleware hooks for plugins
-
pluginRoutes() public
Run routes hooks for loaded plugins
-
routes() public
Define the routes for an application.
-
setEventManager() public
Returns the Cake\Event\EventManagerInterface instance for this object.
Method Detail
__construct() ¶ public
__construct(string $configDir, Cake\Event\EventManagerInterface $eventManager = null, Cake\Http\ControllerFactoryInterface $controllerFactory = null)Constructor
Parameters
-
string$configDir The directory the bootstrap configuration is held in.
-
Cake\Event\EventManagerInterface$eventManager optional Application event manager instance.
-
Cake\Http\ControllerFactoryInterface$controllerFactory optional Controller factory.
addOptionalPlugin() ¶ public
addOptionalPlugin(stringCake\Core\PluginInterface $name, array $config = []): $thisAdd an optional plugin
If it isn't available, ignore it.
Parameters
-
stringCake\Core\PluginInterface$name The plugin name or plugin object.
-
array$config optional The configuration data for the plugin if using a string for $name
Returns
$thisaddPlugin() ¶ public
addPlugin(stringCake\Core\PluginInterface $name, array $config = []): $thisAdd a plugin to the loaded plugin set.
If the named plugin does not exist, or does not define a Plugin class, an
instance of Cake\Core\BasePlugin will be used. This generated class will have
all plugin hooks enabled.
Parameters
-
stringCake\Core\PluginInterface$name -
array$config optional
Returns
$thisbootstrap() ¶ public
bootstrap(): voidLoad all the application configuration and bootstrap logic.
Override this method to add additional bootstrap logic for your application.
Returns
voidconsole() ¶ public
console(Cake\Console\CommandCollection $commands): Cake\Console\CommandCollectionDefine the console commands for an application.
By default all commands in CakePHP, plugins and the application will be loaded using conventions based names.
Parameters
-
Cake\Console\CommandCollection$commands The CommandCollection to add commands into.
Returns
Cake\Console\CommandCollectiondispatchEvent() ¶ public
dispatchEvent(string $name, array|null $data = null, object|null $subject = null): Cake\Event\EventInterfaceWrapper for creating and dispatching events.
Returns a dispatched event.
Parameters
-
string$name Name of the event.
-
array|null$data optional Any value you wish to be transported with this event to it can be read by listeners.
-
object|null$subject optional The object that this event applies to ($this by default).
Returns
Cake\Event\EventInterfacegetEventManager() ¶ public
getEventManager(): Cake\Event\EventManagerInterfaceReturns the Cake\Event\EventManager manager instance for this object.
You can use this instance to register any new listeners or callbacks to the object events, or create your own events and trigger them at will.
Returns
Cake\Event\EventManagerInterfacegetPlugins() ¶ public
getPlugins(): Cake\Core\PluginCollectionGet the plugin collection in use.
Returns
Cake\Core\PluginCollectionhandle() ¶ public
handle(ServerRequestInterface $request): Psr\Http\Message\ResponseInterfaceInvoke the application.
- Convert the PSR response into CakePHP equivalents.
- Create the controller that will handle this request.
- Invoke the controller.
Parameters
-
ServerRequestInterface$request The request
Returns
Psr\Http\Message\ResponseInterfacemiddleware() ¶ abstract public
middleware(Cake\Http\MiddlewareQueue $middlewareQueue): Cake\Http\MiddlewareQueueDefine the HTTP middleware layers for an application.
Parameters
-
Cake\Http\MiddlewareQueue$middlewareQueue The middleware queue to set in your App Class
Returns
Cake\Http\MiddlewareQueuepluginBootstrap() ¶ public
pluginBootstrap(): voidRun bootstrap logic for loaded plugins.
Returns
voidpluginConsole() ¶ public
pluginConsole(Cake\Console\CommandCollection $commands): Cake\Console\CommandCollectionRun console hooks for plugins
Parameters
-
Cake\Console\CommandCollection$commands
Returns
Cake\Console\CommandCollectionpluginMiddleware() ¶ public
pluginMiddleware(Cake\Http\MiddlewareQueue $middleware): Cake\Http\MiddlewareQueueRun middleware hooks for plugins
Parameters
-
Cake\Http\MiddlewareQueue$middleware
Returns
Cake\Http\MiddlewareQueuepluginRoutes() ¶ public
pluginRoutes(Cake\Routing\RouteBuilder $routes): Cake\Routing\RouteBuilderRun routes hooks for loaded plugins
Parameters
-
Cake\Routing\RouteBuilder$routes
Returns
Cake\Routing\RouteBuilderroutes() ¶ public
routes(Cake\Routing\RouteBuilder $routes): voidDefine the routes for an application.
By default this will load config/routes.php for ease of use and backwards compatibility.
Parameters
-
Cake\Routing\RouteBuilder$routes A route builder to add routes into.
Returns
voidsetEventManager() ¶ public
setEventManager(Cake\Event\EventManagerInterface $eventManager): $thisReturns the Cake\Event\EventManagerInterface instance for this object.
You can use this instance to register any new listeners or callbacks to the object events, or create your own events and trigger them at will.
Parameters
-
Cake\Event\EventManagerInterface$eventManager the eventManager to set
Returns
$thisProperty Detail
$_eventManager ¶ protected
Instance of the Cake\Event\EventManager this object is using to dispatch inner events.
Type
Cake\Event\EventManagerInterface