F3路由靠配置和约定，需在Base实例初始化后、run()前注册；GET用get()方法声明路径与回调，PARAMS自动注入占位符值；POST需显式声明且匹配method和路径；reroute()软跳转触发新匹配，halt()硬终止输出；生命周期为beforeroute→匹配→回调→afterroute。
Fat-Free Framework（F3）的路由不是靠“实现”，而是靠配置和约定——它的核心路由机制早已内置，你只需要正确声明路径、方法和回调即可。试图手动重写 Router 类或绕过 Base::instance()->route() 通常只会引入不可预测的行为。
怎么写一个能被 F3 正确匹配的 GET 路由
F3 的路由注册必须在 Base 实例初始化之后、run() 之前完成；路径支持占位符（如 @id），但不支持正则内联语法（如 /user/(?<id>\d+)</id>）。
-
$f3 = Base::instance();是必须的第一步，所有后续操作都依赖它 - GET 路由用
$f3->get('/user/@id', function($f3) { echo $f3->get('PARAMS.id'); });，注意PARAMS是自动注入的数组，键名来自@xxx占位符 - 如果路径含查询参数（如
?page=2），F3 不会将其纳入路由匹配，但可通过$f3->get('GET.page')读取 - 不要在回调中直接
return内容——F3 不捕获返回值，必须用echo或print
POST 请求为什么总 404 或跳转失败
F3 对 HTTP 方法区分严格，默认只响应显式声明的 post()、put() 等方法；表单提交未带 method="post" 或被 JS 拦截后未正确设置 Content-Type，都会导致匹配失败。
- 确保 HTML 表单有
method="post"，且 action 路径与$f3->post('/login', ...)完全一致（包括末尾斜杠） - F3 默认不解析
application/json请求体，若用 AJAX 发送 JSON，需手动解析：$raw = file_get_contents('php://input'); $data = json_decode($raw, true); - CSRF 防护需自行实现，F3 不内置验证逻辑；常见错误是提交时漏传隐藏字段或 token 校验失败后未终止流程
- 若使用 Nginx，确认已启用
try_files规则，否则 POST 请求可能因重写规则丢失方法类型
reroute() 和 halt() 的实际作用差异
reroute() 是软跳转：中断当前执行流，重新进入路由器匹配新路径（如从 /old 跳到 /new），URL 地址栏会变化；halt() 是硬终止：立即输出内容并退出，不再走后续中间件或 afterroute 钩子。
立即学习“PHP免费学习笔记（深入）”；
-
$f3->reroute('/dashboard');会触发新一轮路由查找，等效于一次 303 重定向但无 HTTP 跳转开销 -
$f3->halt('Access denied', 403);输出纯文本并设状态码，适合权限拦截场景 - 误用
reroute()可能造成无限循环（如在/a中 reroute 到/a），F3 不做循环检测 - 两者都不触发
afterroute回调——这是容易被忽略的关键点，日志、响应头注入等逻辑若放在这里会失效
真正难的不是写对一个路由，而是理解 F3 的生命周期钩子顺序：beforeroute → 路由匹配 → 回调执行 → afterroute。任何中间环节抛出异常、提前 exit，或在 beforeroute 中修改了 PATH 但没同步更新 VERB，都会让路由行为变得难以追踪。
