---
title: "Abstract class **Phalcon\\Dispatcher**"
version: "3.4"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.phalcon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Abstract class **Phalcon\Dispatcher**

*implements* [Phalcon\DispatcherInterface](/3.4/api/phalcon_di/), [Phalcon\Di\InjectionAwareInterface](/3.4/api/phalcon_di/), [Phalcon\Events\EventsAwareInterface](/3.4/api/phalcon_events/)

<a href="https://github.com/phalcon/cphalcon/tree/v3.4.0/phalcon/dispatcher.zep" class="btn btn-default btn-sm">Source on GitHub</a>

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.

## Constants

*integer* **EXCEPTION_NO_DI**

*integer* **EXCEPTION_CYCLIC_ROUTING**

*integer* **EXCEPTION_HANDLER_NOT_FOUND**

*integer* **EXCEPTION_INVALID_HANDLER**

*integer* **EXCEPTION_INVALID_PARAMS**

*integer* **EXCEPTION_ACTION_NOT_FOUND**

## Methods

public **setDI** ([Phalcon\DiInterface](/3.4/api/phalcon_di/) $dependencyInjector)

Sets the dependency injector

public **getDI** ()

Returns the internal dependency injector

public **setEventsManager** ([Phalcon\Events\ManagerInterface](/3.4/api/phalcon_events/) $eventsManager)

Sets the events manager

public **getEventsManager** ()

Returns the internal event manager

public **setActionSuffix** (*mixed* $actionSuffix)

Sets the default action suffix

public **getActionSuffix** ()

Gets the default action suffix

public **setModuleName** (*mixed* $moduleName)

Sets the module where the controller is (only informative)

public **getModuleName** ()

Gets the module where the controller class is

public **setNamespaceName** (*mixed* $namespaceName)

Sets the namespace where the controller class is

public **getNamespaceName** ()

Gets a namespace to be prepended to the current handler name

public **setDefaultNamespace** (*mixed* $namespaceName)

Sets the default namespace

public **getDefaultNamespace** ()

Returns the default namespace

public **setDefaultAction** (*mixed* $actionName)

Sets the default action name

public **setActionName** (*mixed* $actionName)

Sets the action name to be dispatched

public **getActionName** ()

Gets the latest dispatched action name

public **setParams** (*array* $params)

Sets action params to be dispatched

public **getParams** ()

Gets action params

public **setParam** (*mixed* $param, *mixed* $value)

Set a param by its name or numeric index

public *mixed* **getParam** (*mixed* $param, [*string* | *array* $filters], [*mixed* $defaultValue])

Gets a param by its name or numeric index

public *boolean* **hasParam** (*mixed* $param)

Check if a param exists

public **getActiveMethod** ()

Returns the current method to be/executed in the dispatcher

public **isFinished** ()

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

public **setReturnedValue** (*mixed* $value)

Sets the latest returned value by an action manually

public *mixed* **getReturnedValue** ()

Returns value returned by the latest dispatched action

public **setModelBinding** (*mixed* $value, [*mixed* $cache])

Enable/Disable model binding during dispatch

```php
<?php

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

$dispatcher->setModelBinding(true, 'cache');
return $dispatcher;
});

```

public **setModelBinder** ([Phalcon\Mvc\Model\BinderInterface](/3.4/api/phalcon_mvc_model_binder/) $modelBinder, [*mixed* $cache])

Enable model binding during dispatch

```php
<?php

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

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

```

public **getModelBinder** ()

Gets model binder

public *object* **dispatch** ()

Dispatches a handle action taking into account the routing parameters

protected *object* **_dispatch** ()

Dispatches a handle action taking into account the routing parameters

public **forward** (*array* $forward)

Forwards the execution flow to another controller/action.

```php
<?php

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

```

public **wasForwarded** ()

Check if the current executed action was forwarded by another one

public **getHandlerClass** ()

Possible class name that will be located to dispatch the request

public **callActionMethod** (*mixed* $handler, *mixed* $actionMethod, [*array* $params])

...

public **getBoundModels** ()

Returns bound models from binder instance

```php
<?php

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

```

protected **_resolveEmptyProperties** ()

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

<hr />

# Interface **Phalcon\DispatcherInterface**

<a href="https://github.com/phalcon/cphalcon/tree/v3.4.0/phalcon/dispatcherinterface.zep" class="btn btn-default btn-sm">Source on GitHub</a>

## Methods

abstract public **setActionSuffix** (*mixed* $actionSuffix)

...

abstract public **getActionSuffix** ()

...

abstract public **setDefaultNamespace** (*mixed* $defaultNamespace)

...

abstract public **setDefaultAction** (*mixed* $actionName)

...

abstract public **setNamespaceName** (*mixed* $namespaceName)

...

abstract public **setModuleName** (*mixed* $moduleName)

...

abstract public **setActionName** (*mixed* $actionName)

...

abstract public **getActionName** ()

...

abstract public **setParams** (*mixed* $params)

...

abstract public **getParams** ()

...

abstract public **setParam** (*mixed* $param, *mixed* $value)

...

abstract public **getParam** (*mixed* $param, [*mixed* $filters])

...

abstract public **hasParam** (*mixed* $param)

...

abstract public **isFinished** ()

...

abstract public **getReturnedValue** ()

...

abstract public **dispatch** ()

...

abstract public **forward** (*mixed* $forward)

...

Source: https://docs.phalcon.io/3.4/api/phalcon_dispatcher/index.mdx