Dispatcher Class Info:

Class Declaration:

class Dispatcher extends Object

File name:
cake/dispatcher.php
Description:

Dispatcher translates URLs to controller-action-paramter triads.

Dispatches the request, creating appropriate models and controllers.

Class Inheritance

Object

Package
cake
Subpackage
cake.cake

Properties:

Show/Hide parent properties
  • base string

    Base URL

  • here string

    Current URL

  • params string

    the params for this request

  • webroot string

    webroot path

asset

top

Checks if a requested asset exists and sends it to the browser

Parameters:
  • $url required

Method defined in:
cake/dispatcher.php on line 560
Return

boolean True on success if the asset file was found and sent

Access

public

baseUrl

top

Returns a base URL and sets the proper webroot

Method defined in:
cake/dispatcher.php on line 323
Return

string Base URL

Access

public

cached

top

Outputs cached dispatch view cache

Parameters:
  • string $url required

    Requested URL

Method defined in:
cake/dispatcher.php on line 523
Access

public

cakeError

top

Used to report user friendly errors. If there is a file app/error.php or app/app_error.php this file will be loaded error.php is the AppError class it should extend ErrorHandler class.

Parameters:
  • string $method required

    Method to be called in the error class (AppError or ErrorHandler classes)

  • array $messages optional array ( )

    Message that is to be displayed by the error class

Method defined in:
cake/libs/object.php on line 187
Return

error message

Access

public

__construct

top

Constructor.

Parameters:
  • $url optional NULL

  • $base optional false

Method defined in:
cake/dispatcher.php on line 75

_deliverAsset

top

Sends an asset file to the client

Parameters:
  • string $assetFile required

    Path to the asset file in the file system

  • string $ext required

    The extension of the file to determine its mime type

Method defined in:
cake/dispatcher.php on line 622
Return

void

Access

protected

dispatch

top

Dispatches and invokes given URL, handing over control to the involved controllers, and then renders the results (if autoRender is set).

If no controller of given name can be found, invoke() shows error messages in the form of Missing Controllers information. It does the same with Actions (methods of Controllers are called Actions).

Parameters:
  • string $url optional NULL

    URL information to work on

  • array $additionalParams optional array ( )

    Settings array ("bare", "return") which is melded with the GET and POST params

Method defined in:
cake/dispatcher.php on line 97
Return

boolean Success

Access

public

dispatchMethod

top

Calls a method on this object with the given parameters. Provides an OO wrapper for call_user_func_array

Parameters:
  • string $method required

    Name of the method to call

  • array $params optional array ( )

    Parameter list to use when calling $method

Method defined in:
cake/libs/object.php on line 107
Return

mixed Returns the result of the method call

Access

public

getUrl

top

Returns and sets the $_GET[url] derived from the REQUEST_URI

Parameters:
  • string $uri optional NULL

    Request URI

  • string $base optional NULL

    Base path

Method defined in:
cake/dispatcher.php on line 474
Return

string URL

Access

public

_invoke

top

Initializes the components and models a controller will be using. Triggers the controller action, and invokes the rendering if Controller::$autoRender is true and echo's the output. Otherwise the return value of the controller action are returned.

Parameters:
  • object $controller required

    Controller to invoke

  • array $params required

    Parameters with at least the 'action' to invoke

Method defined in:
cake/dispatcher.php on line 185
Return

string Output as sent by controller

Access

protected

log

top

Convience method to write a message to CakeLog. See CakeLog::write() for more information on writing to logs.

Parameters:
  • string $msg required

    Log message

  • integer $type optional 2

    Error type constant. Defined in app/config/core.php.

Method defined in:
cake/libs/object.php on line 148
Return

boolean Success of log write

Access

public

Object

top

A hack to support __construct() on PHP 4 Hint: descendant classes have no PHP4 class_name() constructors, so this constructor gets called first and calls the top-layer __construct() which (if present) should call parent::__construct()

Method defined in:
cake/libs/object.php on line 43
Return

Object

parseParams

top

Returns array of GET and POST parameters. GET parameters are taken from given URL.

Parameters:
  • string $fromUrl required

    URL to mine for parameter information.

Method defined in:
cake/dispatcher.php on line 244
Return

array Parameters found in POST and GET.

Access

public

_persist

top

Checks for a persistent class file, if found file is opened and true returned If file is not found a file is created and false returned If used in other locations of the model you should choose a unique name for the persistent file There are many uses for this method, see manual for examples

Parameters:
  • string $name required

    name of the class to persist

  • $return required

  • string $object required

    the object to persist

  • $type optional NULL

Method defined in:
cake/libs/object.php on line 218
Return

boolean Success

Access

protected

Todo

add examples to manual

requestAction

top

Calls a controller's method from any location. Can be used to connect controllers together or tie plugins into a main application. requestAction can be used to return rendered views or fetch the return value from controller actions.

Parameters:
  • mixed $url required

    String or array-based url.

  • array $extra optional array ( )

    if array includes the key "return" it sets the AutoRender to true.

Method defined in:
cake/libs/object.php on line 80
Return

mixed Boolean true or false on success/failure, or contents of rendered action if 'return' is set in $extra.

Access

public

_savePersistent

top

You should choose a unique name for the persistent file

There are many uses for this method, see manual for examples

Parameters:
  • string $name required

    name used for object to cache

  • object $object required

    the object to persist

Method defined in:
cake/libs/object.php on line 247
Return

boolean true on save, throws error if file can not be created

Access

protected

_set

top

Allows setting of multiple properties of the object in a single line of code. Will only set properties that are part of a class declaration.

Parameters:
  • array $properties optional array ( )

    An associative array containing properties and corresponding values.

Method defined in:
cake/libs/object.php on line 166
Return

void

Access

protected

_stop

top

Stop execution of the current script. Wraps exit() making testing easier.

Parameters:
  • $status optional 0

Method defined in:
cake/libs/object.php on line 135
Return

void

Access

public

toString

top

Object-to-string conversion. Each class can override this method as necessary.

Method defined in:
cake/libs/object.php on line 64
Return

string The name of this class

Access

public

uri

top

Returns the REQUEST_URI from the server environment, or, failing that, constructs a new one, using the PHP_SELF constant and other variables.

Method defined in:
cake/dispatcher.php on line 427
Return

string URI

Access

public