// +---------------------------------------------------------------------- declare (strict_types = 1); namespace think\route; use think\Route; /** * 资源路由类 */ class Resource extends RuleGroup { /** * REST方法定义 * @var array */ protected $rest = []; /** * 模型绑定 * @var array */ protected $model = []; /** * 数据验证 * @var array */ protected $validate = []; /** * 中间件 * @var array */ protected $middleware = []; /** * 架构函数 * @access public * @param Route $router 路由对象 * @param RuleGroup|null $parent 上级对象 * @param string $name 资源名称 * @param string $route 路由地址 * @param array $rest 资源定义 */ public function __construct(Route $router, RuleGroup $parent = null, string $name = '', string $route = '', array $rest = []) { $name = ltrim($name, '/'); $this->router = $router; $this->parent = $parent; $this->rule = $name; $this->route = $route; $this->name = strpos($name, '.') ? strstr($name, '.', true) : $name; $this->setFullName(); // 资源路由默认为完整匹配 $this->option['complete_match'] = true; $this->rest = $rest; if ($this->parent) { $this->domain = $this->parent->getDomain(); $this->parent->addRuleItem($this); } } /** * 解析资源路由规则 * @access public * @param mixed $rule 路由规则 * @return void */ public function parseGroupRule($rule): void { $option = $this->option; $origin = $this->router->getGroup(); $this->router->setGroup($this); if (strpos($rule, '.')) { // 注册嵌套资源路由 $array = explode('.', $rule); $last = array_pop($array); $item = []; foreach ($array as $val) { $item[] = $val . '/<' . ($option['var'][$val] ?? $val . '_id') . '>'; } $rule = implode('/', $item) . '/' . $last; } $prefix = substr($rule, strlen($this->name) + 1); // 注册资源路由 foreach ($this->rest as $key => $val) { if ((isset($option['only']) && !in_array($key, $option['only'])) || (isset($option['except']) && in_array($key, $option['except']))) { continue; } if (isset($last) && strpos($val[1], '') && isset($option['var'][$last])) { $val[1] = str_replace('', '<' . $option['var'][$last] . '>', $val[1]); } elseif (strpos($val[1], '') && isset($option['var'][$rule])) { $val[1] = str_replace('', '<' . $option['var'][$rule] . '>', $val[1]); } $ruleItem = $this->addRule(trim($prefix . $val[1], '/'), $this->route . '/' . $val[2], $val[0]); foreach (['model', 'validate', 'middleware', 'pattern'] as $name) { if (isset($this->$name[$key])) { call_user_func_array([$ruleItem, $name], (array) $this->$name[$key]); } } } $this->router->setGroup($origin); $this->hasParsed = true; } /** * 设置资源允许 * @access public * @param array $only 资源允许 * @return $this */ public function only(array $only) { return $this->setOption('only', $only); } /** * 设置资源排除 * @access public * @param array $except 排除资源 * @return $this */ public function except(array $except) { return $this->setOption('except', $except); } /** * 设置资源路由的变量 * @access public * @param array $vars 资源变量 * @return $this */ public function vars(array $vars) { return $this->setOption('var', $vars); } /** * 绑定资源验证 * @access public * @param array|string $name 资源类型或者验证信息 * @param array|string $validate 验证信息 * @return $this */ public function withValidate($name, $validate = []) { if (is_array($name)) { $this->validate = array_merge($this->validate, $name); } else { $this->validate[$name] = $validate; } return $this; } /** * 绑定资源模型 * @access public * @param array|string $name 资源类型或者模型绑定 * @param array|string $model 模型绑定 * @return $this */ public function withModel($name, $model = []) { if (is_array($name)) { $this->model = array_merge($this->model, $name); } else { $this->model[$name] = $model; } return $this; } /** * 绑定资源中间件 * @access public * @param array|string $name 资源类型或者中间件定义 * @param array|string $middleware 中间件定义 * @return $this */ public function withMiddleware($name, $middleware = []) { if (is_array($name)) { $this->middleware = array_merge($this->middleware, $name); } else { $this->middleware[$name] = $middleware; } return $this; } /** * rest方法定义和修改 * @access public * @param array|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; } }