add() public method

Add a route to the collection.
public add ( Route $route, array $options = [] ) : void
$route Cake\Routing\Route\Route The route object to add.
$options array Additional options for the route. Primarily for the `_name` option, which enables named routes.
return void
示例#1
0
 /**
  * Connects a new Route.
  *
  * Routes are a way of connecting request URLs to objects in your application.
  * At their core routes are a set or regular expressions that are used to
  * match requests to destinations.
  *
  * Examples:
  *
  * ```
  * $routes->connect('/:controller/:action/*');
  * ```
  *
  * The first parameter will be used as a controller name while the second is
  * used as the action name. The '/*' syntax makes this route greedy in that
  * it will match requests like `/posts/index` as well as requests
  * like `/posts/edit/1/foo/bar`.
  *
  * ```
  * $routes->connect('/home-page', ['controller' => 'Pages', 'action' => 'display', 'home']);
  * ```
  *
  * The above shows the use of route parameter defaults. And providing routing
  * parameters for a static route.
  *
  * ```
  * $routes->connect(
  *   '/:lang/:controller/:action/:id',
  *   [],
  *   ['id' => '[0-9]+', 'lang' => '[a-z]{3}']
  * );
  * ```
  *
  * Shows connecting a route with custom route parameters as well as
  * providing patterns for those parameters. Patterns for routing parameters
  * do not need capturing groups, as one will be added for each route params.
  *
  * $options offers several 'special' keys that have special meaning
  * in the $options array.
  *
  * - `pass` is used to define which of the routed parameters should be shifted
  *   into the pass array. Adding a parameter to pass will remove it from the
  *   regular route array. Ex. `'pass' => ['slug']`.
  * - `routeClass` is used to extend and change how individual routes parse requests
  *   and handle reverse routing, via a custom routing class.
  *   Ex. `'routeClass' => 'SlugRoute'`
  * -  `persist` is used to define which route parameters should be automatically
  *   included when generating new URLs. You can override persistent parameters
  *   by redefining them in a URL or remove them by setting the parameter to `false`.
  *   Ex. `'persist' => ['lang']`
  * - `_name` is used to define a specific name for routes. This can be used to optimize
  *   reverse routing lookups. If undefined a name will be generated for each
  *   connected route.
  * - `_ext` is an array of filename extensions that will be parsed out of the url if present.
  *   See {@link ScopedRouteCollection::extensions()}.
  * - `_method` Only match requests with specific HTTP verbs.
  *
  * Example of using the `_method` condition:
  *
  * ```
  * $routes->connect('/tasks', ['controller' => 'Tasks', 'action' => 'index', '_method' => 'GET']);
  * ```
  *
  * The above route will only be matched for GET requests. POST requests will fail to match this route.
  *
  * @param string $route A string describing the template of the route
  * @param array $defaults An array describing the default route parameters. These parameters will be used by default
  *   and can supply routing parameters that are not dynamic. See above.
  * @param array $options An array matching the named elements in the route to regular expressions which that
  *   element should match. Also contains additional parameters such as which routed parameters should be
  *   shifted into the passed arguments, supplying patterns for routing parameters and supplying the name of a
  *   custom routing class.
  * @return void
  * @throws \InvalidArgumentException
  * @throws \BadMethodCallException
  */
 public function connect($route, array $defaults = [], array $options = [])
 {
     if (empty($options['action'])) {
         $defaults += ['action' => 'index'];
     }
     if (empty($options['_ext'])) {
         $options['_ext'] = $this->_extensions;
     }
     if (empty($options['routeClass'])) {
         $options['routeClass'] = $this->_routeClass;
     }
     $route = $this->_makeRoute($route, $defaults, $options);
     $this->_collection->add($route, $options);
 }
示例#2
0
 /**
  * Connects a new Route.
  *
  * Routes are a way of connecting request URLs to objects in your application.
  * At their core routes are a set or regular expressions that are used to
  * match requests to destinations.
  *
  * Examples:
  *
  * ```
  * $routes->connect('/:controller/:action/*');
  * ```
  *
  * The first parameter will be used as a controller name while the second is
  * used as the action name. The '/*' syntax makes this route greedy in that
  * it will match requests like `/posts/index` as well as requests
  * like `/posts/edit/1/foo/bar`.
  *
  * ```
  * $routes->connect('/home-page', ['controller' => 'Pages', 'action' => 'display', 'home']);
  * ```
  *
  * The above shows the use of route parameter defaults. And providing routing
  * parameters for a static route.
  *
  * ```
  * $routes->connect(
  *   '/:lang/:controller/:action/:id',
  *   [],
  *   ['id' => '[0-9]+', 'lang' => '[a-z]{3}']
  * );
  * ```
  *
  * Shows connecting a route with custom route parameters as well as
  * providing patterns for those parameters. Patterns for routing parameters
  * do not need capturing groups, as one will be added for each route params.
  *
  * $options offers several 'special' keys that have special meaning
  * in the $options array.
  *
  * - `pass` is used to define which of the routed parameters should be shifted
  *   into the pass array. Adding a parameter to pass will remove it from the
  *   regular route array. Ex. `'pass' => ['slug']`.
  * - `routeClass` is used to extend and change how individual routes parse requests
  *   and handle reverse routing, via a custom routing class.
  *   Ex. `'routeClass' => 'SlugRoute'`
  * -  `persist` is used to define which route parameters should be automatically
  *   included when generating new URLs. You can override persistent parameters
  *   by redefining them in a URL or remove them by setting the parameter to `false`.
  *   Ex. `'persist' => ['lang']`
  * - `multibytePattern` Set to true to enable multibyte pattern support in route
  *   parameter patterns.
  * - `_name` is used to define a specific name for routes. This can be used to optimize
  *   reverse routing lookups. If undefined a name will be generated for each
  *   connected route.
  * - `_ext` is an array of filename extensions that will be parsed out of the url if present.
  *   See {@link ScopedRouteCollection::extensions()}.
  * - `_method` Only match requests with specific HTTP verbs.
  *
  * Example of using the `_method` condition:
  *
  * ```
  * $routes->connect('/tasks', ['controller' => 'Tasks', 'action' => 'index', '_method' => 'GET']);
  * ```
  *
  * The above route will only be matched for GET requests. POST requests will fail to match this route.
  *
  * @param string $route A string describing the template of the route
  * @param array $defaults An array describing the default route parameters. These parameters will be used by default
  *   and can supply routing parameters that are not dynamic. See above.
  * @param array $options An array matching the named elements in the route to regular expressions which that
  *   element should match. Also contains additional parameters such as which routed parameters should be
  *   shifted into the passed arguments, supplying patterns for routing parameters and supplying the name of a
  *   custom routing class.
  * @return void
  * @throws \InvalidArgumentException
  * @throws \BadMethodCallException
  */
 public function connect($route, array $defaults = [], array $options = [])
 {
     if (!isset($options['action']) && !isset($defaults['action'])) {
         $defaults['action'] = 'index';
     }
     if (empty($options['_ext'])) {
         $options['_ext'] = $this->_extensions;
     }
     if (empty($options['routeClass'])) {
         $options['routeClass'] = $this->_routeClass;
     }
     if (isset($options['_name']) && $this->_namePrefix) {
         $options['_name'] = $this->_namePrefix . $options['_name'];
     }
     $route = $this->_makeRoute($route, $defaults, $options);
     $this->_collection->add($route, $options);
 }
示例#3
0
 /**
  * Connects a new Route in the router.
  *
  * Routes are a way of connecting request URLs to objects in your application.
  * At their core routes are a set or regular expressions that are used to
  * match requests to destinations.
  *
  * Examples:
  *
  * `Router::connect('/:controller/:action/*');`
  *
  * The first parameter will be used as a controller name while the second is
  * used as the action name. The '/*' syntax makes this route greedy in that
  * it will match requests like `/posts/index` as well as requests
  * like `/posts/edit/1/foo/bar`.
  *
  * `Router::connect('/home-page', ['controller' => 'pages', 'action' => 'display', 'home']);`
  *
  * The above shows the use of route parameter defaults. And providing routing
  * parameters for a static route.
  *
  * {{{
  * Router::connect(
  *   '/:lang/:controller/:action/:id',
  *   [],
  *   ['id' => '[0-9]+', 'lang' => '[a-z]{3}']
  * );
  * }}}
  *
  * Shows connecting a route with custom route parameters as well as
  * providing patterns for those parameters. Patterns for routing parameters
  * do not need capturing groups, as one will be added for each route params.
  *
  * $options offers several 'special' keys that have special meaning
  * in the $options array.
  *
  * - `pass` is used to define which of the routed parameters should be shifted
  *   into the pass array. Adding a parameter to pass will remove it from the
  *   regular route array. Ex. `'pass' => array('slug')`.
  * - `routeClass` is used to extend and change how individual routes parse requests
  *   and handle reverse routing, via a custom routing class.
  *   Ex. `'routeClass' => 'SlugRoute'`
  * - `_name` is used to define a specific name for routes. This can be used to optimize
  *   reverse routing lookups. If undefined a name will be generated for each
  *   connected route.
  * - `_ext` is an array of filename extensions that will be parsed out of the url if present.
  *   See {@link Route::parseExtensions()}.
  *
  * You can also add additional conditions for matching routes to the $defaults array.
  * The following conditions can be used:
  *
  * - `[type]` Only match requests for specific content types.
  * - `[method]` Only match requests with specific HTTP verbs.
  * - `[server]` Only match when $_SERVER['SERVER_NAME'] matches the given value.
  *
  * Example of using the `[method]` condition:
  *
  * `Router::connect('/tasks', array('controller' => 'tasks', 'action' => 'index', '[method]' => 'GET'));`
  *
  * The above route will only be matched for GET requests. POST requests will fail to match this route.
  *
  * @param string $route A string describing the template of the route
  * @param array $defaults An array describing the default route parameters. These parameters will be used by default
  *   and can supply routing parameters that are not dynamic. See above.
  * @param array $options An array matching the named elements in the route to regular expressions which that
  *   element should match. Also contains additional parameters such as which routed parameters should be
  *   shifted into the passed arguments, supplying patterns for routing parameters and supplying the name of a
  *   custom routing class.
  * @see routes
  * @return void
  * @throws \Cake\Error\Exception
  */
 public static function connect($route, $defaults = [], $options = [])
 {
     static::$initialized = true;
     $defaults += ['plugin' => null];
     if (empty($options['action'])) {
         $defaults += array('action' => 'index');
     }
     if (empty($options['_ext'])) {
         $options['_ext'] = static::$_validExtensions;
     }
     $routeClass = static::$_routeClass;
     if (isset($options['routeClass'])) {
         $routeClass = App::classname($options['routeClass'], 'Routing/Route');
         $routeClass = static::_validateRouteClass($routeClass);
         unset($options['routeClass']);
     }
     if ($routeClass === 'Cake\\Routing\\Route\\RedirectRoute' && isset($defaults['redirect'])) {
         $defaults = $defaults['redirect'];
     }
     static::$_routes->add(new $routeClass($route, $defaults, $options));
 }