ThinkPHP 6+ 彻底移除了 input()、get() 等全局函数,必须通过依赖注入 think\Request 实例获取请求数据,如 public function index(Request $request) { $request->param('name'); }。

为什么 input() 和 get() 突然不工作了
ThinkPHP 6+ 彻底移除了全局函数 input()、get()、post() 等,不是“弃用警告”,是直接报 Fatal error: Uncaught Error: Call to undefined function input()。这不是配置问题,是框架底层删掉了这些函数定义。
根本原因是 TP6 要求显式依赖注入和类型安全,所有请求数据必须通过 think\Request 实例获取。硬编码调用全局函数会破坏容器管理、无法 mock 测试、也拦不住非法参数穿透。
- 旧代码里写
input('name')或get('id')的地方,全部会崩 - TP5.1 升级到 TP6 时最容易卡在这一步,尤其在控制器方法外或公共函数里用了这些函数
- 别试图用
function_exists('input')做兼容判断——它永远返回 false
Controller 里怎么安全取 Request 数据
必须通过构造函数或方法参数自动注入 think\Request 对象,这是唯一受支持的方式。
错误写法:input('page', 1, 'intval')(直接报错)
立即学习“PHP免费学习笔记(深入)”;
正确写法:把 Request 当作方法参数,框架自动实例化并绑定当前请求上下文
- 控制器方法签名里加
think\Request $request参数,如:public function index(\think\Request $request) - 取值统一用
$request->param('name')(合并 GET/POST)、$request->get('id')(仅 GET)、$request->post('token')(仅 POST) - 过滤和默认值要写在方法内,例如:
$request->param('status', 'all', 'htmlspecialchars'),注意第三个参数是过滤回调,不是字符串规则 - 不要在构造函数里保存
$this->request = $request后反复调用——虽然可行,但违背“一次请求一个 Request 实例”的设计意图,且容易引发生命周期混淆
param()、get()、post() 的行为差异与陷阱
这三个方法看似只是来源不同,实际在参数解析、数组支持、空值处理上都有隐式差异,不注意会漏数据或报错。
-
$request->param('user.name')可以自动解析嵌套键(如user[name]表单),但$request->post('user.name')不行——它只认原始键名,不会做点号展开 -
$request->get('id')对 URL 中未传的参数返回null,而$request->param('id')在 POST 提交同名字段时可能意外覆盖 GET 值 - 批量取值如
$request->only(['name', 'email'])默认只从param层取,若想限定来源,得显式传第二个参数:$request->only(['id'], 'get') - 所有方法对空字符串
''、'0'、0的判定逻辑一致,但不会自动过滤掉null或未定义键——需自行用isset()或array_key_exists()判断
跨控制器/服务类怎么复用 Request 处理逻辑
不能在 Service 类里直接 new think\Request,那会创建一个无上下文的空实例,get() 全是空数组。
正确路径只有两条:传参 or 注入。优先选传参,更轻量、更易测试。
- 需要封装通用校验逻辑?把
$request当参数传进去,例如:$this->validateUser($request) - 真要依赖注入,就在 Service 构造函数声明
think\Request $request,但必须确保该 Service 是由容器创建(即控制器里用app()->make(Service::class)或注解注入),否则容器不会自动绑定 - 绝对避免在静态方法里调用
Request::instance()—— TP6 已删除该静态方法,且静态访问破坏请求隔离性 - 如果业务逻辑完全不依赖请求数据,就别传
Request;强行塞进去只会让单元测试变重、耦合变高
最常被忽略的是:TP6 的 Request 实例本身不缓存原始输入流(如 PUT/JSON),首次调用 $request->param() 后再调用 $request->rawInput() 可能拿不到原始内容。需要原始体的场景,务必先读 rawInput(),再手动解析,别指望多次调用 param() 能稳定还原。



















