UNDER THE HOOD
让每个请求,有迹可循。
通过 PHP 或 JSON 规则,把自定义 URL 映射到命名空间控制器。
路由实验室
输入一个参数,通过 PHP 自定义路由 /r/:slug 访问当前页面。
本次执行
- 原始请求
- /r/hello?source=examples
- 控制器文件
- app/Lab/RouteController.php
- 实际方法
- Lab\RouteController::Entry($request, $response)
$request->route(映射后的完整路径)
[
"lab",
"route",
"entry",
"hello"
]
$request->get(查询参数独立保留)
{
"source": "examples"
}
可直接运行的自定义路由
| URL | 配置来源 | 映射结果 |
|---|---|---|
| /r/hello?source=php | routes.php | /lab/route/entry/hello |
| /r-json/hello?source=json | routes.json | /lab/route/entry/hello |
| /r-pair/2026/11 | routes.json,多参数 | /lab/route/entry/2026/11 |
| /tasks | routes.json,固定地址 | /workspace/main/entry |
| /tasks.json | routes.json,GET 接口 | /workspace/main/api |
| /lab/route/entry/hello | 默认命名空间路径 | Lab\RouteController::Entry |
规则按注册顺序取第一条匹配项;查询串不参与匹配。未命中时保留默认命名空间调度。/tasks/save 映射到 Save,仍只允许 POST,并保留 CSRF 校验。
PHP 配置:samples/config/routes.php
<?php
use SlightPHP\Route;
// PHP 规则:/r/hello -> /lab/route/entry/hello。
Route::set([
'pattern' => '^\/r\/:slug$',
':slug' => '[A-Za-z0-9_]{1,40}',
'zone' => 'lab',
'page' => 'route',
'entry' => 'entry',
]);
// JSON 数组中的规则追加在 PHP 规则之后,首条匹配规则优先。
Route::setConfigFile(__DIR__ . '/routes.json');
JSON 配置:samples/config/routes.json
[
{
"pattern": "^\\/r-json\\/:slug$",
":slug": "[A-Za-z0-9_]{1,40}",
"zone": "lab",
"page": "route",
"entry": "entry"
},
{
"pattern": "^\\/r-pair\\/:year\\/:month$",
":year": "\\d{4}",
":month": "(?:0[1-9]|1[0-2])",
"zone": "lab",
"page": "route",
"entry": "entry"
},
{
"pattern": "^\\/tasks$",
"zone": "workspace",
"page": "main",
"entry": "entry"
},
{
"pattern": "^\\/tasks\\.json$",
"zone": "workspace",
"page": "main",
"entry": "api"
},
{
"pattern": "^\\/tasks\\/save$",
"zone": "workspace",
"page": "main",
"entry": "save"
}
]
入口在 run() 前加载配置,再用 Route::parse($routePath) 匹配已去除 index.php 的原始路径。pattern 不带外围分隔符,斜杠写成 \/;占位符正则使用 (?:...) 避免额外捕获组。