1: <?php
 2: /**
 3:  * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
 4:  * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
 5:  *
 6:  * Licensed under The MIT License
 7:  * For full copyright and license information, please see the LICENSE.txt
 8:  * Redistributions of files must retain the above copyright notice.
 9:  *
10:  * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
11:  * @link          https://cakephp.org CakePHP(tm) Project
12:  * @since         1.3.0
13:  * @license       https://opensource.org/licenses/mit-license.php MIT License
14:  */
15: namespace Cake\Routing\Route;
16: 
17: /**
18:  * Plugin short route, that copies the plugin param to the controller parameters
19:  * It is used for supporting /:plugin routes.
20:  */
21: class PluginShortRoute extends InflectedRoute
22: {
23: 
24:     /**
25:      * Parses a string URL into an array. If a plugin key is found, it will be copied to the
26:      * controller parameter.
27:      *
28:      * @param string $url The URL to parse
29:      * @param string $method The HTTP method
30:      * @return array|false An array of request parameters, or boolean false on failure.
31:      */
32:     public function parse($url, $method = '')
33:     {
34:         $params = parent::parse($url, $method);
35:         if (!$params) {
36:             return false;
37:         }
38:         $params['controller'] = $params['plugin'];
39: 
40:         return $params;
41:     }
42: 
43:     /**
44:      * Reverses route plugin shortcut URLs. If the plugin and controller
45:      * are not the same the match is an auto fail.
46:      *
47:      * @param array $url Array of parameters to convert to a string.
48:      * @param array $context An array of the current request context.
49:      *   Contains information such as the current host, scheme, port, and base
50:      *   directory.
51:      * @return string|false Either a string URL for the parameters if they match or false.
52:      */
53:     public function match(array $url, array $context = [])
54:     {
55:         if (isset($url['controller'], $url['plugin']) && $url['plugin'] !== $url['controller']) {
56:             return false;
57:         }
58:         $this->defaults['controller'] = $url['controller'];
59:         $result = parent::match($url, $context);
60:         unset($this->defaults['controller']);
61: 
62:         return $result;
63:     }
64: }
65: