<?php
|
// +----------------------------------------------------------------------
|
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
|
// +----------------------------------------------------------------------
|
// | Copyright (c) 2006~2025 http://thinkphp.cn All rights reserved.
|
// +----------------------------------------------------------------------
|
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
|
// +----------------------------------------------------------------------
|
// | Author: liu21st <liu21st@gmail.com>
|
// +----------------------------------------------------------------------
|
declare(strict_types=1);
|
|
namespace think\route;
|
|
/**
|
* 路由标识管理类
|
*/
|
class RuleName
|
{
|
/**
|
* 路由标识
|
* @var array
|
*/
|
protected $item = [];
|
|
/**
|
* 路由规则
|
* @var array
|
*/
|
protected $rule = [];
|
|
/**
|
* 路由分组
|
* @var array
|
*/
|
protected $group = [];
|
|
/**
|
* 注册路由标识
|
* @access public
|
* @param string $name 路由标识
|
* @param RuleItem $ruleItem 路由规则
|
* @param bool $first 是否优先
|
* @return void
|
*/
|
public function setName(string $name, RuleItem $ruleItem, bool $first = false): void
|
{
|
$name = strtolower($name);
|
$item = $this->getRuleItemInfo($ruleItem);
|
if ($first && isset($this->item[$name])) {
|
array_unshift($this->item[$name], $item);
|
} else {
|
$this->item[$name][] = $item;
|
}
|
}
|
|
/**
|
* 注册路由分组标识
|
* @access public
|
* @param string $name 路由分组标识
|
* @param RuleGroup $group 路由分组
|
* @return void
|
*/
|
public function setGroup(string $name, RuleGroup $group): void
|
{
|
$this->group[strtolower($name)] = $group;
|
}
|
|
/**
|
* 注册路由规则
|
* @access public
|
* @param string $rule 路由规则
|
* @param RuleItem $ruleItem 路由
|
* @return void
|
*/
|
public function setRule(string $rule, RuleItem $ruleItem): void
|
{
|
$route = $ruleItem->getRoute();
|
|
if (is_string($route)) {
|
$this->rule[$rule][$route] = $ruleItem;
|
} else {
|
$this->rule[$rule][] = $ruleItem;
|
}
|
}
|
|
/**
|
* 根据路由规则获取路由对象（列表）
|
* @access public
|
* @param string $rule 路由标识
|
* @return RuleItem[]
|
*/
|
public function getRule(string $rule): array
|
{
|
return $this->rule[$rule] ?? [];
|
}
|
|
/**
|
* 根据路由分组标识获取分组
|
* @access public
|
* @param string $name 路由分组标识
|
* @return RuleGroup|null
|
*/
|
public function getGroup(string $name): ?RuleGroup
|
{
|
return $this->group[strtolower($name)] ?? null;
|
}
|
|
/**
|
* 清空路由规则
|
* @access public
|
* @return void
|
*/
|
public function clear(): void
|
{
|
$this->item = [];
|
$this->rule = [];
|
$this->group = [];
|
}
|
|
/**
|
* 获取全部路由列表
|
* @access public
|
* @return array
|
*/
|
public function getRuleList(): array
|
{
|
$list = [];
|
|
foreach ($this->rule as $rule => $rules) {
|
foreach ($rules as $item) {
|
$val = [];
|
|
foreach (['method', 'rule', 'name', 'route', 'domain', 'pattern', 'option'] as $param) {
|
$call = 'get' . $param;
|
$val[$param] = $item->$call();
|
}
|
|
if ($item->isMiss()) {
|
$val['rule'] .= '<MISS>';
|
}
|
|
$list[] = $val;
|
}
|
}
|
|
return $list;
|
}
|
|
/**
|
* 导入路由标识
|
* @access public
|
* @param array $item 路由标识
|
* @return void
|
*/
|
public function import(array $item): void
|
{
|
$this->item = $item;
|
}
|
|
/**
|
* 根据路由标识获取路由信息（用于URL生成）
|
* @access public
|
* @param string $name 路由标识
|
* @param string $domain 域名
|
* @param string $method 请求类型
|
* @return array
|
*/
|
public function getName(?string $name = null, ?string $domain = null, string $method = '*'): array
|
{
|
if (is_null($name)) {
|
return $this->item;
|
}
|
|
$name = strtolower($name);
|
$method = strtolower($method);
|
$result = [];
|
|
if (isset($this->item[$name])) {
|
if (is_null($domain)) {
|
$result = $this->item[$name];
|
} else {
|
foreach ($this->item[$name] as $item) {
|
$itemDomain = $item['domain'];
|
$itemMethod = $item['method'];
|
|
if (($itemDomain == $domain || '-' == $itemDomain) && ('*' == $itemMethod || '*' == $method || $method == $itemMethod)) {
|
$result[] = $item;
|
}
|
}
|
}
|
}
|
|
return $result;
|
}
|
|
/**
|
* 获取路由信息
|
* @access protected
|
* @param RuleItem $item 路由规则
|
* @return array
|
*/
|
protected function getRuleItemInfo(RuleItem $item): array
|
{
|
return [
|
'rule' => $item->getRule(),
|
'domain' => $item->getDomain(),
|
'method' => $item->getMethod(),
|
'suffix' => $item->getSuffix(),
|
];
|
}
|
}
|
