tp5路由必须通过route类注册，因路由系统基于其静态方法构建，普通函数不参与url匹配；闭包可作为route方法参数使用，但控制器方式更推荐。
TP5 不能直接用“自定义函数”写路由，必须通过 Route 类注册，否则请求根本不会被识别为路由规则。
为什么不能直接写函数当路由？
ThinkPHP5 的路由系统是基于 Route 类的静态方法构建的，所有路由规则都需经由 Route::get、Route::post 等方法注册进全局路由表。你写的普通函数（比如 function myHandler() { ... }）只是 PHP 可执行代码，不参与 URL 匹配流程，也不会被框架调用。
常见错误现象：
– 在 route.php 里写了函数但访问对应 URL 仍报 404
– 函数执行了，但控制器没收到参数、input() 拿不到值
– 路由缓存生成后该规则彻底消失
- 路由不是“挂载函数”，而是“声明映射关系”：URL → 控制器方法 或 闭包
- 闭包是唯一能“写函数逻辑”的合法方式，但它必须作为
Route::get等方法的第二个参数传入 - 函数体里不能直接用
$this或依赖控制器生命周期（如中间件、过滤器），除非手动模拟
正确写法：用闭包当路由目标
闭包是 TP5 支持的合法路由地址类型，适合轻量逻辑、调试或临时接口：
use think\Route;
Route::get('api/time', function () {
return json(['time' => date('Y-m-d H:i:s')]);
});
Route::post('upload/test', function (\think\Request $request) {
$file = $request->file('image');
if ($file) {
return $file->move(ROOT_PATH . 'public' . DS . 'uploads');
}
return 'no file';
});
- 闭包参数可选，支持
\think\Request实例，也可不写（用input()获取） - 返回值会被自动转为响应，无需
return response()->json(...)那套 - 注意：闭包路由无法享受控制器级别的中间件自动绑定（如权限检查），需手动加
->middleware(...) - 上线前务必运行
php think optimize:route，否则闭包路由在缓存模式下会失效
更推荐的做法：写控制器方法，再路由过去
绝大多数场景下，应该把逻辑写进控制器，再用路由指向它——这是 TP5 设计的正向路径，能复用验证、中间件、模型等全部能力：
// application/index/controller/Api.php
<?php namespace app\index\controller;
use think\Controller;
class Api extends Controller
{
public function time()
{
return json(['time' => date('Y-m-d H:i:s')]);
}
public function upload()
{
$file = request()->file('image');
return $file ? $file->move(ROOT_PATH . 'public/uploads') : 'no file';
}
}
// route.php
use think\Route;
Route::get('api/time', 'index/Api/time');
Route::post('upload/test', 'index/Api/upload');
- 控制器方法天然支持依赖注入、验证器、钩子，闭包做不到
- 路由表达式中的动态参数（如
user/:id）会自动注入到控制器方法形参，闭包需手动input('id') - 如果想复用某段逻辑，应封装成服务类或助手函数，而不是硬塞进闭包
容易忽略的关键点
哪怕只写一条闭包路由，以下三件事也必须同步做，否则大概率出问题：
-
config/app.php中确认'url_route_on' => true，否则所有Route::*都不生效 -
'url_route_must' => false（初学阶段别设为true，否则没注册的首页都会 404） - 开发完立刻执行
php think optimize:route，尤其用了闭包或变量规则时，缓存不更新会导致匹配失败
闭包看着简单，但一旦涉及参数校验、上传处理、数据库操作，很快就会变得难以维护。真正需要“自定义函数式路由”的地方，往往说明该逻辑本该抽离成服务层，而不是卡在路由定义里。
