|
@@ -0,0 +1,990 @@
|
|
|
+<?php
|
|
|
+// +----------------------------------------------------------------------
|
|
|
+// | ThinkPHP [ WE CAN DO IT JUST THINK ]
|
|
|
+// +----------------------------------------------------------------------
|
|
|
+// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
|
|
|
+// +----------------------------------------------------------------------
|
|
|
+// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
|
|
|
+// +----------------------------------------------------------------------
|
|
|
+// | Author: liu21st <liu21st@gmail.com>
|
|
|
+// +----------------------------------------------------------------------
|
|
|
+
|
|
|
+namespace think;
|
|
|
+
|
|
|
+use think\exception\RouteNotFoundException;
|
|
|
+use think\route\AliasRule;
|
|
|
+use think\route\dispatch\Url as UrlDispatch;
|
|
|
+use think\route\Domain;
|
|
|
+use think\route\Resource;
|
|
|
+use think\route\RuleGroup;
|
|
|
+use think\route\RuleItem;
|
|
|
+
|
|
|
+class Route
|
|
|
+{
|
|
|
+ /**
|
|
|
+ * REST定义
|
|
|
+ * @var array
|
|
|
+ */
|
|
|
+ protected $rest = [
|
|
|
+ 'index' => ['get', '', 'index'],
|
|
|
+ 'create' => ['get', '/create', 'create'],
|
|
|
+ 'edit' => ['get', '/<id>/edit', 'edit'],
|
|
|
+ 'read' => ['get', '/<id>', 'read'],
|
|
|
+ 'save' => ['post', '', 'save'],
|
|
|
+ 'update' => ['put', '/<id>', 'update'],
|
|
|
+ 'delete' => ['delete', '/<id>', 'delete'],
|
|
|
+ ];
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 请求方法前缀定义
|
|
|
+ * @var array
|
|
|
+ */
|
|
|
+ protected $methodPrefix = [
|
|
|
+ 'get' => 'get',
|
|
|
+ 'post' => 'post',
|
|
|
+ 'put' => 'put',
|
|
|
+ 'delete' => 'delete',
|
|
|
+ 'patch' => 'patch',
|
|
|
+ ];
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 应用对象
|
|
|
+ * @var App
|
|
|
+ */
|
|
|
+ protected $app;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 请求对象
|
|
|
+ * @var Request
|
|
|
+ */
|
|
|
+ protected $request;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 当前HOST
|
|
|
+ * @var string
|
|
|
+ */
|
|
|
+ protected $host;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 当前域名
|
|
|
+ * @var string
|
|
|
+ */
|
|
|
+ protected $domain;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 当前分组对象
|
|
|
+ * @var RuleGroup
|
|
|
+ */
|
|
|
+ protected $group;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 配置参数
|
|
|
+ * @var array
|
|
|
+ */
|
|
|
+ protected $config = [];
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 路由绑定
|
|
|
+ * @var array
|
|
|
+ */
|
|
|
+ protected $bind = [];
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 域名对象
|
|
|
+ * @var array
|
|
|
+ */
|
|
|
+ protected $domains = [];
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 跨域路由规则
|
|
|
+ * @var RuleGroup
|
|
|
+ */
|
|
|
+ protected $cross;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 路由别名
|
|
|
+ * @var array
|
|
|
+ */
|
|
|
+ protected $alias = [];
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 路由是否延迟解析
|
|
|
+ * @var bool
|
|
|
+ */
|
|
|
+ protected $lazy = true;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 路由是否测试模式
|
|
|
+ * @var bool
|
|
|
+ */
|
|
|
+ protected $isTest;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * (分组)路由规则是否合并解析
|
|
|
+ * @var bool
|
|
|
+ */
|
|
|
+ protected $mergeRuleRegex = true;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 路由解析自动搜索多级控制器
|
|
|
+ * @var bool
|
|
|
+ */
|
|
|
+ protected $autoSearchController = true;
|
|
|
+
|
|
|
+ public function __construct(App $app, array $config = [])
|
|
|
+ {
|
|
|
+ $this->app = $app;
|
|
|
+ $this->request = $app['request'];
|
|
|
+ $this->config = $config;
|
|
|
+
|
|
|
+ $this->host = $this->request->host(true) ?: $config['app_host'];
|
|
|
+
|
|
|
+ $this->setDefaultDomain();
|
|
|
+ }
|
|
|
+
|
|
|
+ public function config($name = null)
|
|
|
+ {
|
|
|
+ if (is_null($name)) {
|
|
|
+ return $this->config;
|
|
|
+ }
|
|
|
+
|
|
|
+ return isset($this->config[$name]) ? $this->config[$name] : null;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 配置
|
|
|
+ * @access public
|
|
|
+ * @param array $config
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function setConfig(array $config = [])
|
|
|
+ {
|
|
|
+ $this->config = array_merge($this->config, array_change_key_case($config));
|
|
|
+ }
|
|
|
+
|
|
|
+ public static function __make(App $app, Config $config)
|
|
|
+ {
|
|
|
+ $config = $config->pull('app');
|
|
|
+ $route = new static($app, $config);
|
|
|
+
|
|
|
+ $route->lazy($config['url_lazy_route'])
|
|
|
+ ->autoSearchController($config['controller_auto_search'])
|
|
|
+ ->mergeRuleRegex($config['route_rule_merge']);
|
|
|
+
|
|
|
+ return $route;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置路由的请求对象实例
|
|
|
+ * @access public
|
|
|
+ * @param Request $request 请求对象实例
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function setRequest($request)
|
|
|
+ {
|
|
|
+ $this->request = $request;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置路由域名及分组(包括资源路由)是否延迟解析
|
|
|
+ * @access public
|
|
|
+ * @param bool $lazy 路由是否延迟解析
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function lazy($lazy = true)
|
|
|
+ {
|
|
|
+ $this->lazy = $lazy;
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置路由为测试模式
|
|
|
+ * @access public
|
|
|
+ * @param bool $test 路由是否测试模式
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function setTestMode($test)
|
|
|
+ {
|
|
|
+ $this->isTest = $test;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 检查路由是否为测试模式
|
|
|
+ * @access public
|
|
|
+ * @return bool
|
|
|
+ */
|
|
|
+ public function isTest()
|
|
|
+ {
|
|
|
+ return $this->isTest;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置路由域名及分组(包括资源路由)是否合并解析
|
|
|
+ * @access public
|
|
|
+ * @param bool $merge 路由是否合并解析
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function mergeRuleRegex($merge = true)
|
|
|
+ {
|
|
|
+ $this->mergeRuleRegex = $merge;
|
|
|
+ $this->group->mergeRuleRegex($merge);
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置路由自动解析是否搜索多级控制器
|
|
|
+ * @access public
|
|
|
+ * @param bool $auto 是否自动搜索多级控制器
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function autoSearchController($auto = true)
|
|
|
+ {
|
|
|
+ $this->autoSearchController = $auto;
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 初始化默认域名
|
|
|
+ * @access protected
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ protected function setDefaultDomain()
|
|
|
+ {
|
|
|
+ // 默认域名
|
|
|
+ $this->domain = $this->host;
|
|
|
+
|
|
|
+ // 注册默认域名
|
|
|
+ $domain = new Domain($this, $this->host);
|
|
|
+
|
|
|
+ $this->domains[$this->host] = $domain;
|
|
|
+
|
|
|
+ // 默认分组
|
|
|
+ $this->group = $domain;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置当前域名
|
|
|
+ * @access public
|
|
|
+ * @param RuleGroup $group 域名
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function setGroup(RuleGroup $group)
|
|
|
+ {
|
|
|
+ $this->group = $group;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 获取当前分组
|
|
|
+ * @access public
|
|
|
+ * @return RuleGroup
|
|
|
+ */
|
|
|
+ public function getGroup()
|
|
|
+ {
|
|
|
+ return $this->group;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册变量规则
|
|
|
+ * @access public
|
|
|
+ * @param string|array $name 变量名
|
|
|
+ * @param string $rule 变量规则
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function pattern($name, $rule = '')
|
|
|
+ {
|
|
|
+ $this->group->pattern($name, $rule);
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册路由参数
|
|
|
+ * @access public
|
|
|
+ * @param string|array $name 参数名
|
|
|
+ * @param mixed $value 值
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function option($name, $value = '')
|
|
|
+ {
|
|
|
+ $this->group->option($name, $value);
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册域名路由
|
|
|
+ * @access public
|
|
|
+ * @param string|array $name 子域名
|
|
|
+ * @param mixed $rule 路由规则
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return Domain
|
|
|
+ */
|
|
|
+ public function domain($name, $rule = '', $option = [], $pattern = [])
|
|
|
+ {
|
|
|
+ // 支持多个域名使用相同路由规则
|
|
|
+ $domainName = is_array($name) ? array_shift($name) : $name;
|
|
|
+
|
|
|
+ if ('*' != $domainName && false === strpos($domainName, '.')) {
|
|
|
+ $domainName .= '.' . $this->request->rootDomain();
|
|
|
+ }
|
|
|
+
|
|
|
+ if (!isset($this->domains[$domainName])) {
|
|
|
+ $domain = (new Domain($this, $domainName, $rule, $option, $pattern))
|
|
|
+ ->lazy($this->lazy)
|
|
|
+ ->mergeRuleRegex($this->mergeRuleRegex);
|
|
|
+
|
|
|
+ $this->domains[$domainName] = $domain;
|
|
|
+ } else {
|
|
|
+ $domain = $this->domains[$domainName];
|
|
|
+ $domain->parseGroupRule($rule);
|
|
|
+ }
|
|
|
+
|
|
|
+ if (is_array($name) && !empty($name)) {
|
|
|
+ $root = $this->request->rootDomain();
|
|
|
+ foreach ($name as $item) {
|
|
|
+ if (false === strpos($item, '.')) {
|
|
|
+ $item .= '.' . $root;
|
|
|
+ }
|
|
|
+
|
|
|
+ $this->domains[$item] = $domainName;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ // 返回域名对象
|
|
|
+ return $domain;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 获取域名
|
|
|
+ * @access public
|
|
|
+ * @return array
|
|
|
+ */
|
|
|
+ public function getDomains()
|
|
|
+ {
|
|
|
+ return $this->domains;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置路由绑定
|
|
|
+ * @access public
|
|
|
+ * @param string $bind 绑定信息
|
|
|
+ * @param string $domain 域名
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function bind($bind, $domain = null)
|
|
|
+ {
|
|
|
+ $domain = is_null($domain) ? $this->domain : $domain;
|
|
|
+
|
|
|
+ $this->bind[$domain] = $bind;
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 读取路由绑定
|
|
|
+ * @access public
|
|
|
+ * @param string $domain 域名
|
|
|
+ * @return string|null
|
|
|
+ */
|
|
|
+ public function getBind($domain = null)
|
|
|
+ {
|
|
|
+ if (is_null($domain)) {
|
|
|
+ $domain = $this->domain;
|
|
|
+ } elseif (true === $domain) {
|
|
|
+ return $this->bind;
|
|
|
+ } elseif (false === strpos($domain, '.')) {
|
|
|
+ $domain .= '.' . $this->request->rootDomain();
|
|
|
+ }
|
|
|
+
|
|
|
+ $subDomain = $this->request->subDomain();
|
|
|
+
|
|
|
+ if (strpos($subDomain, '.')) {
|
|
|
+ $name = '*' . strstr($subDomain, '.');
|
|
|
+ }
|
|
|
+
|
|
|
+ if (isset($this->bind[$domain])) {
|
|
|
+ $result = $this->bind[$domain];
|
|
|
+ } elseif (isset($name) && isset($this->bind[$name])) {
|
|
|
+ $result = $this->bind[$name];
|
|
|
+ } elseif (!empty($subDomain) && isset($this->bind['*'])) {
|
|
|
+ $result = $this->bind['*'];
|
|
|
+ } else {
|
|
|
+ $result = null;
|
|
|
+ }
|
|
|
+
|
|
|
+ return $result;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 读取路由标识
|
|
|
+ * @access public
|
|
|
+ * @param string $name 路由标识
|
|
|
+ * @param string $domain 域名
|
|
|
+ * @return mixed
|
|
|
+ */
|
|
|
+ public function getName($name = null, $domain = null, $method = '*')
|
|
|
+ {
|
|
|
+ return $this->app['rule_name']->get($name, $domain, $method);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 读取路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param string $domain 域名
|
|
|
+ * @return array
|
|
|
+ */
|
|
|
+ public function getRule($rule, $domain = null)
|
|
|
+ {
|
|
|
+ if (is_null($domain)) {
|
|
|
+ $domain = $this->domain;
|
|
|
+ }
|
|
|
+
|
|
|
+ return $this->app['rule_name']->getRule($rule, $domain);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 读取路由
|
|
|
+ * @access public
|
|
|
+ * @param string $domain 域名
|
|
|
+ * @return array
|
|
|
+ */
|
|
|
+ public function getRuleList($domain = null)
|
|
|
+ {
|
|
|
+ return $this->app['rule_name']->getRuleList($domain);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 批量导入路由标识
|
|
|
+ * @access public
|
|
|
+ * @param array $name 路由标识
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function setName($name)
|
|
|
+ {
|
|
|
+ $this->app['rule_name']->import($name);
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 导入配置文件的路由规则
|
|
|
+ * @access public
|
|
|
+ * @param array $rules 路由规则
|
|
|
+ * @param string $type 请求类型
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function import(array $rules, $type = '*')
|
|
|
+ {
|
|
|
+ // 检查域名部署
|
|
|
+ if (isset($rules['__domain__'])) {
|
|
|
+ foreach ($rules['__domain__'] as $key => $rule) {
|
|
|
+ $this->domain($key, $rule);
|
|
|
+ }
|
|
|
+ unset($rules['__domain__']);
|
|
|
+ }
|
|
|
+
|
|
|
+ // 检查变量规则
|
|
|
+ if (isset($rules['__pattern__'])) {
|
|
|
+ $this->pattern($rules['__pattern__']);
|
|
|
+ unset($rules['__pattern__']);
|
|
|
+ }
|
|
|
+
|
|
|
+ // 检查路由别名
|
|
|
+ if (isset($rules['__alias__'])) {
|
|
|
+ foreach ($rules['__alias__'] as $key => $val) {
|
|
|
+ $this->alias($key, $val);
|
|
|
+ }
|
|
|
+ unset($rules['__alias__']);
|
|
|
+ }
|
|
|
+
|
|
|
+ // 检查资源路由
|
|
|
+ if (isset($rules['__rest__'])) {
|
|
|
+ foreach ($rules['__rest__'] as $key => $rule) {
|
|
|
+ $this->resource($key, $rule);
|
|
|
+ }
|
|
|
+ unset($rules['__rest__']);
|
|
|
+ }
|
|
|
+
|
|
|
+ // 检查路由规则(包含分组)
|
|
|
+ foreach ($rules as $key => $val) {
|
|
|
+ if (is_numeric($key)) {
|
|
|
+ $key = array_shift($val);
|
|
|
+ }
|
|
|
+
|
|
|
+ if (empty($val)) {
|
|
|
+ continue;
|
|
|
+ }
|
|
|
+
|
|
|
+ if (is_string($key) && 0 === strpos($key, '[')) {
|
|
|
+ $key = substr($key, 1, -1);
|
|
|
+ $this->group($key, $val);
|
|
|
+ } elseif (is_array($val)) {
|
|
|
+ $this->rule($key, $val[0], $type, $val[1], isset($val[2]) ? $val[2] : []);
|
|
|
+ } else {
|
|
|
+ $this->rule($key, $val, $type);
|
|
|
+ }
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册路由规则
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param string $method 请求类型
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function rule($rule, $route, $method = '*', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->group->addRule($rule, $route, $method, $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置跨域有效路由规则
|
|
|
+ * @access public
|
|
|
+ * @param Rule $rule 路由规则
|
|
|
+ * @param string $method 请求类型
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function setCrossDomainRule($rule, $method = '*')
|
|
|
+ {
|
|
|
+ if (!isset($this->cross)) {
|
|
|
+ $this->cross = (new RuleGroup($this))->mergeRuleRegex($this->mergeRuleRegex);
|
|
|
+ }
|
|
|
+
|
|
|
+ $this->cross->addRuleItem($rule, $method);
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 批量注册路由规则
|
|
|
+ * @access public
|
|
|
+ * @param array $rules 路由规则
|
|
|
+ * @param string $method 请求类型
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function rules($rules, $method = '*', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ $this->group->addRules($rules, $method, $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册路由分组
|
|
|
+ * @access public
|
|
|
+ * @param string|array $name 分组名称或者参数
|
|
|
+ * @param array|\Closure $route 分组路由
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleGroup
|
|
|
+ */
|
|
|
+ public function group($name, $route, array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ if (is_array($name)) {
|
|
|
+ $option = $name;
|
|
|
+ $name = isset($option['name']) ? $option['name'] : '';
|
|
|
+ }
|
|
|
+
|
|
|
+ return (new RuleGroup($this, $this->group, $name, $route, $option, $pattern))
|
|
|
+ ->lazy($this->lazy)
|
|
|
+ ->mergeRuleRegex($this->mergeRuleRegex);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function any($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, '*', $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册GET路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function get($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, 'GET', $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册POST路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function post($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, 'POST', $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册PUT路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function put($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, 'PUT', $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册DELETE路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function delete($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, 'DELETE', $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册PATCH路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param mixed $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function patch($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, 'PATCH', $option, $pattern);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册资源路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param string $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return Resource
|
|
|
+ */
|
|
|
+ public function resource($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return (new Resource($this, $this->group, $rule, $route, $option, $pattern, $this->rest))
|
|
|
+ ->lazy($this->lazy);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册控制器路由 操作方法对应不同的请求前缀
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由规则
|
|
|
+ * @param string $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleGroup
|
|
|
+ */
|
|
|
+ public function controller($rule, $route = '', array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ $group = new RuleGroup($this, $this->group, $rule, null, $option, $pattern);
|
|
|
+
|
|
|
+ foreach ($this->methodPrefix as $type => $val) {
|
|
|
+ $group->addRule('<action>', $val . '<action>', $type);
|
|
|
+ }
|
|
|
+
|
|
|
+ return $group->prefix($route . '/');
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册视图路由
|
|
|
+ * @access public
|
|
|
+ * @param string|array $rule 路由规则
|
|
|
+ * @param string $template 路由模板地址
|
|
|
+ * @param array $vars 模板变量
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function view($rule, $template = '', array $vars = [], array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $template, 'GET', $option, $pattern)->view($vars);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册重定向路由
|
|
|
+ * @access public
|
|
|
+ * @param string|array $rule 路由规则
|
|
|
+ * @param string $route 路由地址
|
|
|
+ * @param array $status 状态码
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @param array $pattern 变量规则
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function redirect($rule, $route = '', $status = 301, array $option = [], array $pattern = [])
|
|
|
+ {
|
|
|
+ return $this->rule($rule, $route, '*', $option, $pattern)->redirect()->status($status);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册别名路由
|
|
|
+ * @access public
|
|
|
+ * @param string $rule 路由别名
|
|
|
+ * @param string $route 路由地址
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @return AliasRule
|
|
|
+ */
|
|
|
+ public function alias($rule, $route, array $option = [])
|
|
|
+ {
|
|
|
+ $aliasRule = new AliasRule($this, $this->group, $rule, $route, $option);
|
|
|
+
|
|
|
+ $this->alias[$rule] = $aliasRule;
|
|
|
+
|
|
|
+ return $aliasRule;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 获取别名路由定义
|
|
|
+ * @access public
|
|
|
+ * @param string $name 路由别名
|
|
|
+ * @return string|array|null
|
|
|
+ */
|
|
|
+ public function getAlias($name = null)
|
|
|
+ {
|
|
|
+ if (is_null($name)) {
|
|
|
+ return $this->alias;
|
|
|
+ }
|
|
|
+
|
|
|
+ return isset($this->alias[$name]) ? $this->alias[$name] : null;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置不同请求类型下面的方法前缀
|
|
|
+ * @access public
|
|
|
+ * @param string|array $method 请求类型
|
|
|
+ * @param string $prefix 类型前缀
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function setMethodPrefix($method, $prefix = '')
|
|
|
+ {
|
|
|
+ if (is_array($method)) {
|
|
|
+ $this->methodPrefix = array_merge($this->methodPrefix, array_change_key_case($method));
|
|
|
+ } else {
|
|
|
+ $this->methodPrefix[strtolower($method)] = $prefix;
|
|
|
+ }
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 获取请求类型的方法前缀
|
|
|
+ * @access public
|
|
|
+ * @param string $method 请求类型
|
|
|
+ * @param string $prefix 类型前缀
|
|
|
+ * @return string|null
|
|
|
+ */
|
|
|
+ public function getMethodPrefix($method)
|
|
|
+ {
|
|
|
+ $method = strtolower($method);
|
|
|
+
|
|
|
+ return isset($this->methodPrefix[$method]) ? $this->methodPrefix[$method] : null;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * rest方法定义和修改
|
|
|
+ * @access public
|
|
|
+ * @param string $name 方法名称
|
|
|
+ * @param array|bool $resource 资源
|
|
|
+ * @return $this
|
|
|
+ */
|
|
|
+ public function rest($name, $resource = [])
|
|
|
+ {
|
|
|
+ if (is_array($name)) {
|
|
|
+ $this->rest = $resource ? $name : array_merge($this->rest, $name);
|
|
|
+ } else {
|
|
|
+ $this->rest[$name] = $resource;
|
|
|
+ }
|
|
|
+
|
|
|
+ return $this;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 获取rest方法定义的参数
|
|
|
+ * @access public
|
|
|
+ * @param string $name 方法名称
|
|
|
+ * @return array|null
|
|
|
+ */
|
|
|
+ public function getRest($name = null)
|
|
|
+ {
|
|
|
+ if (is_null($name)) {
|
|
|
+ return $this->rest;
|
|
|
+ }
|
|
|
+
|
|
|
+ return isset($this->rest[$name]) ? $this->rest[$name] : null;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册未匹配路由规则后的处理
|
|
|
+ * @access public
|
|
|
+ * @param string $route 路由地址
|
|
|
+ * @param string $method 请求类型
|
|
|
+ * @param array $option 路由参数
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function miss($route, $method = '*', array $option = [])
|
|
|
+ {
|
|
|
+ return $this->group->addMissRule($route, $method, $option);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 注册一个自动解析的URL路由
|
|
|
+ * @access public
|
|
|
+ * @param string $route 路由地址
|
|
|
+ * @return RuleItem
|
|
|
+ */
|
|
|
+ public function auto($route)
|
|
|
+ {
|
|
|
+ return $this->group->addAutoRule($route);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 检测URL路由
|
|
|
+ * @access public
|
|
|
+ * @param string $url URL地址
|
|
|
+ * @param bool $must 是否强制路由
|
|
|
+ * @return Dispatch
|
|
|
+ * @throws RouteNotFoundException
|
|
|
+ */
|
|
|
+ public function check($url, $must = false)
|
|
|
+ {
|
|
|
+ // 自动检测域名路由
|
|
|
+ $domain = $this->checkDomain();
|
|
|
+ $url = str_replace($this->config['pathinfo_depr'], '|', $url);
|
|
|
+
|
|
|
+ $completeMatch = $this->config['route_complete_match'];
|
|
|
+
|
|
|
+ $result = $domain->check($this->request, $url, $completeMatch);
|
|
|
+
|
|
|
+ if (false === $result && !empty($this->cross)) {
|
|
|
+ // 检测跨域路由
|
|
|
+ $result = $this->cross->check($this->request, $url, $completeMatch);
|
|
|
+ }
|
|
|
+
|
|
|
+ if (false !== $result) {
|
|
|
+ // 路由匹配
|
|
|
+ return $result;
|
|
|
+ } elseif ($must) {
|
|
|
+ // 强制路由不匹配则抛出异常
|
|
|
+ throw new RouteNotFoundException();
|
|
|
+ }
|
|
|
+
|
|
|
+ // 默认路由解析
|
|
|
+ return new UrlDispatch($this->request, $this->group, $url, [
|
|
|
+ 'auto_search' => $this->autoSearchController,
|
|
|
+ ]);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 检测域名的路由规则
|
|
|
+ * @access protected
|
|
|
+ * @return Domain
|
|
|
+ */
|
|
|
+ protected function checkDomain()
|
|
|
+ {
|
|
|
+ // 获取当前子域名
|
|
|
+ $subDomain = $this->request->subDomain();
|
|
|
+
|
|
|
+ $item = false;
|
|
|
+
|
|
|
+ if ($subDomain && count($this->domains) > 1) {
|
|
|
+ $domain = explode('.', $subDomain);
|
|
|
+ $domain2 = array_pop($domain);
|
|
|
+
|
|
|
+ if ($domain) {
|
|
|
+ // 存在三级域名
|
|
|
+ $domain3 = array_pop($domain);
|
|
|
+ }
|
|
|
+
|
|
|
+ if ($subDomain && isset($this->domains[$subDomain])) {
|
|
|
+ // 子域名配置
|
|
|
+ $item = $this->domains[$subDomain];
|
|
|
+ } elseif (isset($this->domains['*.' . $domain2]) && !empty($domain3)) {
|
|
|
+ // 泛三级域名
|
|
|
+ $item = $this->domains['*.' . $domain2];
|
|
|
+ $panDomain = $domain3;
|
|
|
+ } elseif (isset($this->domains['*']) && !empty($domain2)) {
|
|
|
+ // 泛二级域名
|
|
|
+ if ('www' != $domain2) {
|
|
|
+ $item = $this->domains['*'];
|
|
|
+ $panDomain = $domain2;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ if (isset($panDomain)) {
|
|
|
+ // 保存当前泛域名
|
|
|
+ $this->request->setPanDomain($panDomain);
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ if (false === $item) {
|
|
|
+ // 检测当前完整域名
|
|
|
+ $item = $this->domains[$this->host];
|
|
|
+ }
|
|
|
+
|
|
|
+ if (is_string($item)) {
|
|
|
+ $item = $this->domains[$item];
|
|
|
+ }
|
|
|
+
|
|
|
+ return $item;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 清空路由规则
|
|
|
+ * @access public
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public function clear()
|
|
|
+ {
|
|
|
+ $this->app['rule_name']->clear();
|
|
|
+ $this->group->clear();
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 设置全局的路由分组参数
|
|
|
+ * @access public
|
|
|
+ * @param string $method 方法名
|
|
|
+ * @param array $args 调用参数
|
|
|
+ * @return RuleGroup
|
|
|
+ */
|
|
|
+ public function __call($method, $args)
|
|
|
+ {
|
|
|
+ return call_user_func_array([$this->group, $method], $args);
|
|
|
+ }
|
|
|
+
|
|
|
+ public function __debugInfo()
|
|
|
+ {
|
|
|
+ $data = get_object_vars($this);
|
|
|
+ unset($data['app'], $data['request']);
|
|
|
+
|
|
|
+ return $data;
|
|
|
+ }
|
|
|
+}
|