Phroute 路由 404 是因 $_SERVER['REQUEST_URI'] 被重写干扰,需检查 Apache .htaccess 或 Nginx try_files 配置;GET/POST 参数需手动处理,JSON 请求须读取 php://input;Dispatcher 类未找到是自动加载问题,应使用 Composer;路由慢常因在注册时执行业务逻辑,应仅声明路径与回调。

Phroute 路由注册后 404?检查 $_SERVER['REQUEST_URI'] 是否被重写干扰
Phroute 默认依赖 $_SERVER['REQUEST_URI'] 解析当前路径,但很多 Apache/Nginx 配置(尤其是没配好 .htaccess 或 try_files)会把真实 URI 改成 /index.php/xxx 或直接丢掉 query string。结果 Phroute 匹配的是带 /index.php 前缀的路径,而你注册的路由是 /user,自然 404。
- Apache 下确保
.htaccess启用且包含标准重写规则:RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php [QSA,L] - Nginx 下确认
location块用了try_files $uri $uri/ /index.php?$query_string;,而不是简单fastcgi_pass直传 - 开发时可临时加一行调试:
var_dump($_SERVER['REQUEST_URI']);,看实际值是不是你预期的/user,还是变成了/index.php/user
如何让 Phroute 正确处理 GET/POST 混合参数
Phroute 本身只管路径匹配,不解析请求体或 query string —— 这点常被误以为是“路由没拿到参数”。$request->get() 或 $_GET 依然可用,但 POST 表单数据需手动读取,尤其遇到 application/json 时容易漏掉。
- GET 参数:直接用
$_GET或filter_input(INPUT_GET, 'id'),Phroute 不干涉 - POST 表单(
application/x-www-form-urlencoded):$_POST自动可用,无需额外操作 - POST JSON(
application/json):必须手动读取原始输入:$raw = file_get_contents('php://input');,再json_decode($raw, true),否则$_POST为空 - 别在路由闭包里直接依赖
$_REQUEST—— 它合并了 GET/POST,但顺序和覆盖逻辑不明确,容易出错
Phroute\Phroute\Dispatcher 报错 Class not found?自动加载没接上
Phroute 不提供 Composer 自动加载配置,如果你用 require 手动引入,又没按 PSR-4 规则组织目录,new Dispatcher 就会失败。错误信息通常是 Class 'Phroute\Phroute\Dispatcher' not found,不是库没装,而是类找不到。
- 推荐方式:用 Composer 安装
composer require phroute/phroute,然后require 'vendor/autoload.php';—— 这是最稳的 - 手动引入时,必须确保
Phroute目录结构完整,并按命名空间逐级require,比如先require 'src/Phroute/RouteCollector.php';再require 'src/Phroute/Dispatcher.php'; - 别跳过
use声明:路由闭包里要用use (\Phroute\Phroute\Dispatcher);,否则Dispatcher是全局命名空间下的未定义类
为什么路由匹配慢?避免在 RouteCollector::get() 里写复杂逻辑
Phroute 的路由注册是静态构建过程,所有 get()、post() 调用都在初始化阶段执行。如果在这些调用里塞了数据库查询、文件读取或远程 API 调用,会导致每次请求都重复执行 —— 不是“路由慢”,是你的注册代码被反复执行了。
立即学习“PHP免费学习笔记(深入)”;
- 注册阶段只做两件事:声明路径 + 绑定回调函数名或闭包,不要在里面查数据库、读配置文件
- 业务逻辑必须放在回调函数内部,例如:
$router->get('/user/{id}', function ($id) { return User::find($id); });,而不是$router->get('/user/{id}', function () { $user = DB::query(...); ... }); - 闭包里用到的类,建议用字符串数组形式延迟加载:
[$controller, 'method'],比匿名函数更易测试也更轻量
真正容易被忽略的是:Phroute 没有中间件机制,权限校验、日志、跨域这些得自己在每个路由回调开头手写,或者封装一个统一入口函数再分发——这点不像框架,得自己兜底。



















