关闭 ThinkPHP 路由需设 'route_on' => false,禁用路由模块以恢复原生 ?s=控制器/方法 模式;注意中间件可能覆盖 $_GET,调试应直接使用 $_GET 或 input('', '', 'string', 'get')。

关闭 ThinkPHP 路由解析:直接禁用路由模块
ThinkPHP 默认开启路由解析,即使你没写任何路由规则,index.php?s=xxx 这类普通 URL 也会被路由层拦截并尝试匹配,导致 $_GET 无法原样获取参数。要真正退回到“普通 URL 模式”,核心不是改配置项,而是让路由不工作。
最稳妥的方式是彻底禁用路由模块,在应用初始化阶段就跳过路由解析流程:
- 在
app/config/app.php(或config/app.php)中设置'route_on' => false - 确保没有启用
'url_route_must' => true,否则会强制走路由,设为false或直接删掉该配置项 - 如果使用了多应用模式,需在对应应用的
config/app.php中设置,而非全局配置
注意:route_on = false 后,URL_MODEL 配置(如 0、1、2)将失效,系统不再生成或解析任何路由 URL,只认 ?s=控制器/方法 和原始 $_GET 参数。
GET 参数获取失败?检查是否被路由中间件吞掉
即使关了 route_on,有些项目仍拿不到 $_GET['xxx'],大概率是中间件提前终止了请求或重写了输入。ThinkPHP 6+ 的 ValidateInput、CheckRequestCache 等内置中间件不会干扰 $_GET,但自定义中间件里如果调用了 $request->get() 或 $request->param() 并做了过滤/合并,就可能覆盖原始值。
立即学习“PHP免费学习笔记(深入)”;
- 检查
app/middleware.php中是否注册了修改请求参数的中间件 - 避免在中间件中调用
$request->only()或$request->except()时传入['s']以外的键名,否则会清空其他 GET 参数 - 调试时可直接在控制器开头加
var_dump($_GET); die;,确认原始参数是否到达 PHP 层
常见错误现象:$_GET 是空数组,但浏览器地址栏明明有 ?id=123&name=test —— 这基本锁定为中间件或入口文件被篡改。
兼容旧版 URL:保留 s=控制器/方法 解析逻辑
关闭路由后,ThinkPHP 仍默认支持 ?s=index/index 这种格式,但前提是没启用模块/多应用隔离。如果你依赖这种写法,要注意几个关键点:
-
s参数必须放在 URL 最前面(如?s=index/test&id=1),否则部分版本会忽略后续参数 - ThinkPHP 5.1+ 对
s参数做了白名单校验,默认只允许字母、数字、下划线、斜杠;若控制器名含短横线(如user-list),需在app/config/app.php中添加'url_common_param' => true并配合正则放开 - 不要在控制器方法里用
input('s')获取路径,它返回的是解析后的控制器/方法字符串,不是原始$_GET['s']
性能影响很小,因为绕过了整套路由匹配循环,但会失去路由别名、闭包路由、资源路由等高级能力 —— 如果只是想保留传统参数传递,这恰恰是预期代价。
为什么 input('param_name') 拿不到值?别混淆输入类型
很多开发者以为 input() 就是万能取参函数,其实它默认从 param(即合并后的请求参数)读取,而 param 在路由关闭后 = $_GET + $_POST + $_REQUEST,但顺序和合并逻辑受 app.use_request_cache 和中间件影响。
- 要 100% 拿到原始 GET 值,必须用
input('param_name', '', 'string', 'get')显式指定来源 - 或更简单:直接用
$_GET['param_name'] ?? null,避开框架封装,尤其适合调试和兼容老逻辑 - 避免在模型或服务类里无条件调用
input(),它依赖当前请求上下文,CLI 模式下会报错或返回空
容易被忽略的地方是:ThinkPHP 的 input() 默认不区分 get/post,只看最终合并结果,而这个“合并结果”在不同版本、不同中间件组合下行为不一致 —— 所以真要稳定,就别图省事。










