Php/docs/yaf-route-regex.construct

• PHP Manual
• Yaf_Route_Regex
• Yaf_Route_Regex constructor

Yaf_Route_Regex::__construct

(Yaf >=1.0.0)

Yaf_Route_Regex::__construct — Yaf_Route_Regex constructor

Description

public Yaf_Route_Regex::__construct ( string $match , array $route [, array $map [, array $verify [, string $reverse ]]] )

Parameters

match

A complete Regex pattern, will be used to match a request uri, if doesn't matched, Yaf_Route_Regex will return FALSE.

route

When the match pattern matches the request uri, Yaf_Route_Regex will use this to decide which m/c/a to routed.

either of m/c/a in this array is optianl, if you don't assgian a specific value, it will be routed to default.

map

A array to assign name to the captrues in the match result.

verify

reverse

a string, used to assemble url, see Yaf_Route_Regex::assemble().

Note:

this parameter is introduced in 2.3.0

Return Values

Examples

Example #1 Yaf_Route_Regex()example

<?php   /**    * Add a regex route to Yaf_Router route stack    */    Yaf_Dispatcher::getInstance()->getRouter()->addRoute("name",        new Yaf_Route_Regex(           "#^/product/([^/]+)/([^/])+#", //match request uri leading "/product"           array(               'controller' => "product",  //route to product controller,           ),           array(              1 => "name",   // now you can call $request->getParam("name")              2 => "id",     // to get the first captrue in the match pattern.           )        )    );?>

Example #2 Yaf_Route_Regex(as of 2.3.0)()example

<?php   /**    * Use match result as MVC name    */    Yaf_Dispatcher::getInstance()->getRouter()->addRoute("name",        new Yaf_Route_Regex(           "#^/product/([^/]+)/([^/])+#i", //match request uri leading "/product"           array(              'controller' => ":name", // route to :name, which is $1 in the match result as controller name           ),           array(              1 => "name",   // now you can call $request->getParam("name")              2 => "id",     // to get the first captrue in the match pattern.           )        )    );?>

Example #3 Yaf_Route_Regex and named capture ground(as of 2.3.0)()example

<?php   /**    * Use match result as MVC name    */    Yaf_Dispatcher::getInstance()->getRouter()->addRoute("name",        new Yaf_Route_Regex(           "#^/product/(?<name>[^/]+)/([^/])+#i", //match request uri leading "/product"           array(           'controller' => ":name", // route to :name,                                    // which is named capture group 'name' in the match result as controller name           ),           array(              2 => "id",     // to get the first captrue in the match pattern.           )        )    );?>

Example #4 Yaf_Route_Regex()example

<?php   /**    * Add a regex route to Yaf_Router route stack by calling addconfig    */    $config = array(        "name" => array(           "type"  => "regex",          //Yaf_Route_Regex route           "match" => "#(.*)#",         //match arbitrary request uri           "route" => array(               'controller' => "product",  //route to product controller,               'action'     => "dummy",    //route to dummy action           ),           "map" => array(              1 => "uri",   // now you can call $request->getParam("uri")           ),        ),    );    Yaf_Dispatcher::getInstance()->getRouter()->addConfig(        new Yaf_Config_Simple($config));?>

See Also

• Yaf_Router::addRoute() - Add new Route into Router
• Yaf_Router::addConfig() - Add config-defined routes into Router
• Yaf_Route_Static
• Yaf_Route_Supervar
• Yaf_Route_Simple
• Yaf_Route_Rewrite
• Yaf_Route_Map