Zend Framework 路由机制源码深度解析

public function __construct($route, $defaults = array(), $reqs = array())
{
  // 清理路径首尾的分隔符（默认为 '/'）
  $route = trim($route, $this->_urlDelimiter);
  
  // 存储默认值和变量约束
  $this->_defaults = (array) $defaults;
  $this->_requirements = (array) $reqs;
  
  if ($route != '') {
    // 按分隔符切割路径，逐个分析片段
    foreach (explode($this->_urlDelimiter, $route) as $pos => $part) {
      // 判断是否为变量段（通常以 ':' 开头）
      if (substr($part, 0, 1) == $this->_urlVariable) {
        $name = substr($part, 1); // 提取变量名
        // 获取该变量的正则约束，若无则使用默认正则
        $regex = (isset($reqs[$name]) ? $reqs[$name] : $this->_defaultRegex);
        
        // 记录结构信息：包含变量名和对应的正则表达式
        $this->_parts[$pos] = array('name' => $name, 'regex' => $regex);
        // 记录所有涉及的变量名称
        $this->_vars[] = $name;
      } else { 
        // 静态文本部分，直接作为字面量正则处理
        $this->_parts[$pos] = array('regex' => $part);
        if ($part != '*') {
          $this->_staticCount++; // 统计静态片段数量，用于后续完整性校验
        }
      }
    }
  }
}

public function match($path)
{
  $pathStaticCount = 0;
  $defaults = $this->_defaults; // 默认值副本
  
  // 构建一个唯一性检查数组，用于追踪变量是否被赋值
  if (count($defaults)) {
    $unique = array_combine(array_keys($defaults), array_fill(0, count($defaults), true));
  } else {
    $unique = array();
  }
  
  // 规范化路径：去除首尾分隔符并分割为数组
  $path = trim($path, $this->_urlDelimiter);
  if ($path != '') {
    $path = explode($this->_urlDelimiter, $path);
    
    // 逐段比对路径片段与规则片段
    foreach ($path as $pos => $pathPart) {
      // 如果规则中没有对应位置的片段，匹配失败
      if (!isset($this->_parts[$pos])) {
        return false;
      }
      
      $part = $this->_parts[$pos];
      
      // 处理通配符 '*' 分支
      if ($part['regex'] == '*') {
        $parts = array_slice($path, $pos); // 截取剩余部分
        $this->_getWildcardData($parts, $unique); // 提取通配符后的键值对
        break; // 通配符匹配后提前结束循环
      }
      
      // 解码路径部分以支持中文等特殊字符
      $pathPart = urldecode($pathPart);
      $name = isset($part['name']) ? $part['name'] : null;
      
      // 三种匹配逻辑分支
      if ($name === null) {
        // 1. 纯静态字符串：必须严格相等
        if ($part['regex'] != $pathPart) {
          return false;
        }
      } elseif ($part['regex'] === null) {
        // 2. 有变量名但无正则约束：只要非空即匹配
        if (strlen($pathPart) == 0) {
          return false;
        }
      } else {
        // 3. 有变量且有正则约束：执行正则验证
        $regex = $this->_regexDelimiter . '^' . $part['regex'] . '$' . $this->_regexDelimiter . 'iu';
        if (!preg_match($regex, $pathPart)) {
          return false;
        }
      }
      
      // 匹配成功，保存变量值或增加静态计数
      if ($name !== null) {
        $this->_values[$name] = $pathPart;
        $unique[$name] = true;
      } else {
        $pathStaticCount++;
      }
    }
  }
  
  // 核心结果生成：优先级依次为 路径解析值 > 通配符参数 > 默认值
  // 使用 + 运算符确保同名 key 时，前者覆盖后者（符合 MVC 路由覆盖逻辑）
  $return = $this->_values + $this->_params + $this->_defaults;
  
  // 校验完成度：规则中的所有静态部分必须在路径中找到
  if ($this->_staticCount != $pathStaticCount) {
    return false;
  }
  // 校验完成度：规则中定义的所有变量必须在结果集中存在
  foreach ($this->_vars as $var) {
    if (!array_key_exists($var, $return)) {
      return false;
    }
  }
  
  return $return;
}