$item
$item : array
路由标识
路由标识管理类
$item : array
路由标识
$rule : array
路由规则
$group : array
路由分组
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2021 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)
{
return $this->group[strtolower($name)] ?? null;
}
/**
* 清空路由规则
* @access public
* @return void
*/
public function clear(): void
{
$this->item = [];
$this->rule = [];
}
/**
* 获取全部路由列表
* @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(),
];
}
}