SLIGHTPHP / SAMPLES
UNDER THE HOOD

让每个请求,有迹可循。

通过 PHP 或 JSON 规则,把自定义 URL 映射到命名空间控制器。

路由实验室

输入一个参数,通过 PHP 自定义路由 /r/:slug 访问当前页面。

本次执行

原始请求
/r-json/hello?source=json
控制器文件
app/Lab/RouteController.php
实际方法
Lab\RouteController::Entry($request, $response)

$request->route(映射后的完整路径)

[
    "lab",
    "route",
    "entry",
    "hello"
]

$request->get(查询参数独立保留)

{
    "source": "json"
}

可直接运行的自定义路由

URL配置来源映射结果
/r/hello?source=phproutes.php/lab/route/entry/hello
/r-json/hello?source=jsonroutes.json/lab/route/entry/hello
/r-pair/2026/11routes.json,多参数/lab/route/entry/2026/11
/tasksroutes.json,固定地址/workspace/main/entry
/tasks.jsonroutes.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 不带外围分隔符,斜杠写成 \/;占位符正则使用 (?:...) 避免额外捕获组。