Hyperf 默认使用 Nikic/FastRoute 作为路由器。

它的本质是FastRoute 是一个基于正则表达式编译和前缀树/分派树 (Dispatch Tree)的轻量级 HTTP 路由器。它不依赖传统的线性遍历或简单的字符串匹配而是在启动阶段将所有路由规则编译成一个高效的数据结构通常是嵌套数组或状态机。在运行时它通过极少的 CPU 指令就能确定请求是否匹配以及提取参数。这是一种牺牲少量启动时间和内存换取极致运行时性能 (O(1) 或 O(log N) 复杂度)的设计哲学。如果把路由匹配比作查字典传统线性路由 (Linear Match)是从头到尾翻书。流程第一条路由/api/user不是。第二条/api/order不是……直到找到或翻完。缺点路由越多查找越慢。O(N) 复杂度。FastRoute是按首字母索引的快速检索系统。流程看第一个字母/- 进入/分支。看第二个字母a- 进入api分支。看第三个部分user- 直接定位到user节点。优点无论字典有多少页只要索引建立得好查找速度几乎恒定。O(1) 或 O(K) 复杂度K 为 URL 层级深度。核心逻辑别在运行时做决定要在启动时把地图画好。运行时只是拿着地图走迷宫而不是现场探路。一、核心原理它是如何工作的FastRoute 的工作分为两个阶段数据生成 (Data Generation)和数据分发 (Data Dispatching)。1. 启动阶段数据生成 (Compilation)输入所有定义的路由来自注解或配置文件。GET /user/{id}POST /userGET /order/{orderId}处理分组按 HTTP 方法GET, POST…分组。正则化将动态参数{id}转换为正则捕获组(\d)如果有约束。构建树构建一个静态分派树 (Static Dispatch Tree)。根节点/子节点user,order叶子节点包含回调函数和参数提取规则。序列化将这个巨大的数组结构序列化为 PHP 代码或缓存文件。输出一个巨大的、优化的 PHP 数组Dispatch Map。2. 运行阶段数据分发 (Dispatching)输入HTTP 请求的方法GET和路径/user/123。处理查找方法表从缓存数组中取出GET对应的子树。逐层匹配检查路径是否以/user/开头是。剩余部分123是否匹配正则\d是。提取参数捕获123作为id。返回结果返回[handler, params]。输出控制器类名和方法名以及参数数组。 核心洞察FastRoute 的核心魔法在于“预计算”。它将复杂的路由匹配逻辑转化为了简单的数组查找和正则执行。二、数据结构Dispatch Map 长什么样虽然实际结构更复杂但概念上类似这样$dispatchMap[GET[// 静态路由/home[HomeController,index],// 动态路由树/user/[// 子树匹配 {id}[regex~^(\d)$~,// 正则suffix,// 后缀handler[UserController,show],// 处理器paramNames[id]// 参数名映射]],/order/[// ...]],POST[/user[UserController,create],]];静态部分直接键值查找极速。动态部分正则匹配但范围被静态前缀大大缩小。三、性能优势为什么选它1. 极低的时间复杂度线性路由1000 条路由平均匹配 500 次。FastRoute1000 条路由通常只需几次数组查找 1 次正则匹配。结果在高并发下CPU 消耗显著降低。2. 零依赖与轻量级FastRoute 只有一个文件核心逻辑无外部依赖。内存占用小适合常驻内存应用Swoole/Hyperf。3. 与 Swoole/Hyperf 的完美契合启动一次运行万次Swoole 进程启动时编译路由之后每个请求都复用这个编译好的结构。无锁竞争路由表是只读的多协程并发读取无需加锁。4. 标准兼容完全符合 PSR-7 (HTTP Message) 和 PSR-15 (Middleware) 标准。四、认知牢笼常见误区1. 误区“FastRoute 支持所有正则特性。”真相为了性能FastRoute 对正则有一些限制。例如不支持 lookahead/lookbehind 等复杂断言因为它们会破坏树的构建逻辑。对策保持路由正则简单如\d,[a-z]。复杂验证留给 Controller。2. 误区“路由越多FastRoute 越慢。”真相FastRoute 的性能随路由数量增长非常平缓对数级或常数级。即使有几千条路由性能损耗也可忽略不计。对策放心定义细粒度路由不必为了性能强行合并。3. 误区“我可以动态添加路由。”真相FastRoute 的路由表是不可变 (Immutable)的。运行时不能addRoute()。对策所有路由必须在启动阶段定义完毕。如果需要动态路由需使用中间件转发或自定义 Router 实现不推荐。4. 误区“FastRoute 比 Nginx 路由快。”真相Nginx 的location匹配是在 C 层进行的且发生在请求到达 PHP 之前。Nginx 永远比 PHP 层路由快。对策在 Nginx 层处理静态文件、重定向、限流。让 FastRoute 只处理业务逻辑路由。5. 误区“修改了路由注解FastRoute 会自动更新。”真相FastRoute 的数据是缓存的。修改注解后必须清除缓存或重启服务重新触发编译过程。对策开发环境使用server:watch它会自动检测变化并重启。 总结原子化“FastRoute”全景图维度关键点本质基于预编译分派树的高性能 HTTP 路由器核心算法静态前缀匹配 动态正则捕获工作阶段启动时编译 (Compile) - 运行时分发 (Dispatch)性能特征O(1)/O(log N) 查找极低 CPU 开销主要优势轻量、无依赖、适合常驻内存、PSR 兼容常见陷阱运行时不可变、复杂正则受限、需清除缓存PHP 隐喻Hash Map Lookup vs. Linear Array Search公式Request_Latency (Tree_Traversal_Time Regex_Match_Time)终极心法FastRoute 的本质是“用空间换时间用预计算换实时性”。别在每次请求时都重新思考路怎么走。把地图刻在脑子里脚步自然轻盈。于编译中见智慧于分派见速度以静态为尺解动态之牛于网络入口中求极速之真。行动指令查看缓存去runtime/container/proxies/或类似目录找找看有没有包含route字样的缓存文件看看生成的 PHP 数组结构。优化正则检查路由中的正则确保它们尽可能简单。压力测试对比增加 100 条路由前后QPS 的变化验证 FastRoute 的稳定性。思维升级记住路由是系统的门面。一个高效的路由器是高并发应用的第一块基石。