\Cake\Routing\FilterControllerFactoryFilter

A dispatcher filter that builds the controller to dispatch in the request.

This filter resolves the request parameters into a controller instance and attaches it to the event object.

Summary

Methods
Properties
Constants
__construct()
implementedEvents()
handle()
matches()
beforeDispatch()
afterDispatch()
setConfig()
getConfig()
config()
configShallow()
No public properties found
No constants found
_configRead()
_configWrite()
_configDelete()
_getController()
$_priority
$_defaultConfig
$_config
$_configInitialized
N/A
No private methods found
No private properties found
N/A

Properties

$_priority

$_priority : integer

Priority is set high to allow other filters to be called first.

Type

integer

$_defaultConfig

$_defaultConfig : array

Default config

These are merged with user-provided config when the class is used. The when and for options allow you to define conditions that are checked before your filter is called.

Type

array

$_config

$_config : array

Runtime config

Type

array

$_configInitialized

$_configInitialized : boolean

Whether the config property has already been configured with defaults

Type

boolean

Methods

__construct()

__construct(array  $config = array()) 

Constructor.

Parameters

array $config

Settings for the filter.

Throws

\InvalidArgumentException

When 'when' conditions are not callable.

implementedEvents()

implementedEvents() : array

Returns the list of events this filter listens to.

Dispatcher notifies 2 different events Dispatcher.before and Dispatcher.after. By default this class will attach preDispatch and postDispatch method respectively.

Override this method at will to only listen to the events you are interested in.

Returns

array

handle()

handle(\Cake\Event\Event  $event) : mixed

Handler method that applies conditions and resolves the correct method to call.

Parameters

\Cake\Event\Event $event

The event instance.

Returns

mixed

matches()

matches(\Cake\Event\Event  $event) : boolean

Check to see if the incoming request matches this filter's criteria.

Parameters

\Cake\Event\Event $event

The event to match.

Returns

boolean

beforeDispatch()

beforeDispatch(\Cake\Event\Event  $event) : void

Resolve the request parameters into a controller and attach the controller to the event object.

If used with default priority, it will be called after the Router has parsed the URL and set the routing params into the request object.

If a Cake\Http\Response object instance is returned, it will be served at the end of the event cycle, not calling any controller as a result. This will also have the effect of not calling the after event in the dispatcher.

If false is returned, the event will be stopped and no more listeners will be notified. Alternatively you can call $event->stopPropagation() to achieve the same result.

Parameters

\Cake\Event\Event $event

The event instance.

afterDispatch()

afterDispatch(\Cake\Event\Event  $event) : void

Method called after the controller served a request and generated a response.

It is possible to alter the response object at this point as it is not sent to the client yet.

If false is returned, the event will be stopped and no more listeners will be notified. Alternatively you can call $event->stopPropagation() to achieve the same result.

Parameters

\Cake\Event\Event $event

container object having the request and response keys in the data property.

setConfig()

setConfig(string|array  $key, mixed|null  $value = null, boolean  $merge = true) : $this

Sets the config.

Usage

Setting a specific value:

$this->setConfig('key', $value);

Setting a nested value:

$this->setConfig('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->setConfig(['one' => 'value', 'another' => 'value']);

Parameters

string|array $key

The key to set, or a complete array of configs.

mixed|null $value

The value to set.

boolean $merge

Whether to recursively merge or overwrite existing config, defaults to true.

Throws

\Cake\Core\Exception\Exception

When trying to set a key that is invalid.

Returns

$this

getConfig()

getConfig(string|null  $key = null, mixed  $default = null) : mixed

Returns the config.

Usage

Reading the whole config:

$this->getConfig();

Reading a specific value:

$this->getConfig('key');

Reading a nested value:

$this->getConfig('some.nested.key');

Reading with default value:

$this->getConfig('some-key', 'default-value');

Parameters

string|null $key

The key to get or null for the whole config.

mixed $default

The return value when the key does not exist.

Returns

mixed —

Config value being read.

config()

config(string|array|null  $key = null, mixed|null  $value = null, boolean  $merge = true) : mixed

Gets/Sets the config.

Usage

Reading the whole config:

$this->config();

Reading a specific value:

$this->config('key');

Reading a nested value:

$this->config('some.nested.key');

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array|null $key

The key to get/set, or a complete array of configs.

mixed|null $value

The value to set.

boolean $merge

Whether to recursively merge or overwrite existing config, defaults to true.

Throws

\Cake\Core\Exception\Exception

When trying to set a key that is invalid.

Returns

mixed —

Config value being read, or the object itself on write operations.

configShallow()

configShallow(string|array  $key, mixed|null  $value = null) : $this

Merge provided config with existing config. Unlike `config()` which does a recursive merge for nested keys, this method does a simple merge.

Setting a specific value:

$this->configShallow('key', $value);

Setting a nested value:

$this->configShallow('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->configShallow(['one' => 'value', 'another' => 'value']);

Parameters

string|array $key

The key to set, or a complete array of configs.

mixed|null $value

The value to set.

Returns

$this

_configRead()

_configRead(string|null  $key) : mixed

Reads a config key.

Parameters

string|null $key

Key to read.

Returns

mixed

_configWrite()

_configWrite(string|array  $key, mixed  $value, boolean|string  $merge = false) : void

Writes a config key.

Parameters

string|array $key

Key to write to.

mixed $value

Value to write.

boolean|string $merge

True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.

Throws

\Cake\Core\Exception\Exception

if attempting to clobber existing config

_configDelete()

_configDelete(string  $key) : void

Deletes a single config key.

Parameters

string $key

Key to delete.

Throws

\Cake\Core\Exception\Exception

if attempting to clobber existing config

_getController()

_getController(\Cake\Http\ServerRequest  $request, \Cake\Http\Response  $response) : \Cake\Controller\Controller

Gets controller to use, either plugin or application controller.

Parameters

\Cake\Http\ServerRequest $request

Request object

\Cake\Http\Response $response

Response for the controller.

Throws

\ReflectionException

Returns

\Cake\Controller\Controller