Phalcon dispatcher

Dispatcher\AbstractDispatcher¶

Abstract Source on GitHub

This is the base class for Phalcon\Mvc\Dispatcher and Phalcon\Cli\Dispatcher. This class can't be instantiated directly, you can use it to create your own dispatchers.

Uses Exception · Phalcon\Di\AbstractInjectionAware · Phalcon\Di\DiInterface · Phalcon\Dispatcher\Exception · Phalcon\Dispatcher\Exceptions\ForwardInInitializeForbidden · Phalcon\Events\EventsAwareInterface · Phalcon\Events\ManagerInterface · Phalcon\Filter\FilterInterface · Phalcon\Mvc\Model\Binder · Phalcon\Mvc\Model\BinderInterface · Phalcon\Support\Collection

Method Summary¶

Properties¶

Methods¶

callActionMethod()¶

public function callActionMethod(
    mixed $handler,
    string $actionMethod,
    array $params = []
);

dispatch()¶

public function dispatch(): mixed|bool;

Process the results of the router by calling into the appropriate controller action(s) including any routing data or injected parameters.

forward()¶

public function forward( array $forward ): void;

Forwards the execution flow to another controller/action.

$this->dispatcher->forward(
    [
        "controller" => "posts",
        "action"     => "index",
    ]
);

getActionName()¶

public function getActionName(): string;

Gets the latest dispatched action name

getActionSuffix()¶

public function getActionSuffix(): string;

Gets the default action suffix

getActiveMethod()¶

public function getActiveMethod(): string;

Returns the current method to be/executed in the dispatcher

getBoundModels()¶

public function getBoundModels(): array;

Returns bound models from binder instance

class UserController extends Controller
{
    public function showAction(User $user)
    {
        // return array with $user
        $boundModels = $this->dispatcher->getBoundModels();
    }
}

getDefaultNamespace()¶

public function getDefaultNamespace(): string;

Returns the default namespace

getEventsManager()¶

public function getEventsManager(): ManagerInterface|null;

Returns the internal event manager

getHandlerClass()¶

public function getHandlerClass(): string;

Possible class name that will be located to dispatch the request

getHandlerSuffix()¶

public function getHandlerSuffix(): string;

Gets the default handler suffix

getModelBinder()¶

public function getModelBinder(): BinderInterface|null;

Gets model binder

getModuleName()¶

public function getModuleName(): string|null;

Gets the module where the controller class is

getNamespaceName()¶

public function getNamespaceName(): string;

Gets a namespace to be prepended to the current handler name

getParam()¶

public function getParam(
    mixed $param,
    mixed $filters = null,
    mixed $defaultValue = null
): mixed;

Gets a param by its name or numeric index

@todo remove this in future versions

getParameter()¶

public function getParameter(
    mixed $param,
    mixed $filters = null,
    mixed $defaultValue = null
): mixed;

Gets a param by its name or numeric index

getParameters()¶

public function getParameters(): array;

Gets action params

getParams()¶

public function getParams(): array;

Gets action params

@todo remove this in future versions

getReturnedValue()¶

public function getReturnedValue(): mixed;

Returns value returned by the latest dispatched action

hasParam()¶

public function hasParam( mixed $param ): bool;

Check if a param exists @todo deprecate this in the future

hasParameter()¶

public function hasParameter( mixed $param ): bool;

Check if a param exists

isFinished()¶

public function isFinished(): bool;

Checks if the dispatch loop is finished or has more pendent controllers/tasks to dispatch

setActionName()¶

public function setActionName( string $actionName ): void;

Sets the action name to be dispatched

setActionSuffix()¶

public function setActionSuffix( string $actionSuffix ): void;

Sets the default action suffix

setDefaultAction()¶

public function setDefaultAction( string $actionName ): void;

Sets the default action name

setDefaultNamespace()¶

public function setDefaultNamespace( string $defaultNamespace ): void;

Sets the default namespace

setEventsManager()¶

public function setEventsManager( ManagerInterface $eventsManager ): void;

Sets the events manager

setHandlerSuffix()¶

public function setHandlerSuffix( string $handlerSuffix ): void;

Sets the default suffix for the handler

setModelBinder()¶

public function setModelBinder(
    BinderInterface $modelBinder,
    mixed $cache = null
): DispatcherInterface;

Enable model binding during dispatch

$di->set(
    'dispatcher',
    function() {
        $dispatcher = new Dispatcher();

        $dispatcher->setModelBinder(
            new Binder(),
            'cache'
        );

        return $dispatcher;
    }
);

setModuleName()¶

public function setModuleName( string $moduleName = null ): void;

Sets the module where the controller is (only informative)

setNamespaceName()¶

public function setNamespaceName( string $namespaceName ): void;

Sets the namespace where the controller class is

setParam()¶

public function setParam(
    mixed $param,
    mixed $value
): void;

Set a param by its name or numeric index @todo deprecate this in the future

setParameter()¶

public function setParameter(
    mixed $param,
    mixed $value
): void;

Set a param by its name or numeric index

setParameters()¶

public function setParameters( array $params ): void;

Sets action params to be dispatched

setParams()¶

public function setParams( array $params ): void;

Sets action params to be dispatched @todo deprecate this in the future

setReturnedValue()¶

public function setReturnedValue( mixed $value ): void;

Sets the latest returned value by an action manually

wasForwarded()¶

public function wasForwarded(): bool;

Check if the current executed action was forwarded by another one

resolveEmptyProperties()¶

protected function resolveEmptyProperties(): void;

Set empty properties to their defaults (where defaults are available)

toCamelCase()¶

protected function toCamelCase( string $input ): string;

Dispatcher\DispatcherInterface¶

Interface Source on GitHub

Interface for Phalcon\Dispatcher\AbstractDispatcher

Method Summary¶

Methods¶

dispatch()¶

public function dispatch(): mixed|bool;

Dispatches a handle action taking into account the routing parameters

forward()¶

public function forward( array $forward ): void;

Forwards the execution flow to another controller/action

getActionName()¶

public function getActionName(): string;

Gets last dispatched action name

getActionSuffix()¶

public function getActionSuffix(): string;

Gets the default action suffix

getHandlerSuffix()¶

public function getHandlerSuffix(): string;

Gets the default handler suffix

getParam()¶

public function getParam(
    mixed $param,
    mixed $filters = null
): mixed;

Gets a param by its name or numeric index

getParameter()¶

public function getParameter(
    mixed $param,
    mixed $filters = null
): mixed;

Gets a param by its name or numeric index

getParameters()¶

public function getParameters(): array;

Gets action params

getParams()¶

public function getParams(): array;

Gets action params

getReturnedValue()¶

public function getReturnedValue(): mixed;

Returns value returned by the latest dispatched action

hasParam()¶

public function hasParam( mixed $param ): bool;

Check if a param exists

isFinished()¶

public function isFinished(): bool;

Checks if the dispatch loop is finished or has more pendent controllers/tasks to dispatch

setActionName()¶

public function setActionName( string $actionName ): void;

Sets the action name to be dispatched

setActionSuffix()¶

public function setActionSuffix( string $actionSuffix ): void;

Sets the default action suffix

setDefaultAction()¶

public function setDefaultAction( string $actionName ): void;

Sets the default action name

setDefaultNamespace()¶

public function setDefaultNamespace( string $defaultNamespace ): void;

Sets the default namespace

setHandlerSuffix()¶

public function setHandlerSuffix( string $handlerSuffix ): void;

Sets the default suffix for the handler

setModuleName()¶

public function setModuleName( string $moduleName = null ): void;

Sets the module name which the application belongs to

setNamespaceName()¶

public function setNamespaceName( string $namespaceName ): void;

Sets the namespace which the controller belongs to

setParam()¶

public function setParam(
    mixed $param,
    mixed $value
): void;

Set a param by its name or numeric index

setParams()¶

public function setParams( array $params ): void;

Sets action params to be dispatched

Dispatcher\Exception¶

Class Source on GitHub

Exceptions thrown in Phalcon\Dispatcher/* will use this class

Constants¶

Dispatcher\Exceptions\ForwardInInitializeForbidden¶

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Dispatcher\Exception

Method Summary¶

Methods¶

__construct()¶

public function __construct();