request() 是 Laravel 框架提供的全局辅助函数，非 PHP 原生功能；未加载 Laravel 启动流程（如容器、HTTP 内核）时调用会报错，因其依赖 Illuminate\Http\Request 实例和服务容器绑定。
PHP 本身没有 Request 辅助函数——这是 Laravel 框架提供的功能，不是原生 PHP 的能力。直接在纯 PHP 脚本里调用 request() 或 Request::get() 会报 Class 'Request' not found 或 Call to undefined function request()。
为什么在非 Laravel 环境下 request() 会报错
Laravel 的 request() 是全局辅助函数，由框架在启动时通过服务提供者注册到全局作用域；它底层依赖 Illuminate\Http\Request 实例和容器绑定。没加载 Laravel 启动流程（如 bootstrap/app.php、容器初始化、HTTP 内核），这个函数根本不存在。
-
request()不是 PHP 内置函数，也不是 Composer 自动加载的通用工具 - 即使你
use Illuminate\Http\Request，也必须有实例——不能静态调用Request::get('xxx')（该类无静态get方法） - 常见误操作：把 Laravel 的控制器代码复制到
.php文件里直接运行，必然失败
在 Laravel 控制器中正确获取输入数据的三种方式
真正有效的入口只有 Laravel HTTP 请求生命周期内。推荐按场景选择：
- 简单取值（推荐）：
request('key')或request()->input('key')，支持默认值request('key', 'default') - 带验证的取值：
request()->validated()（需先调用$request->validate([...])） - 从注入的
Request对象取：public function store(Request $request) { $request->post('name'); }—— 注意post()只读 POST/PUT/PATCH 数据，query()读 GET 参数，all()合并所有
别混用：request()->post('email') 和 request('email') 行为不同——后者会自动在 query、request、route、session 中依次查找（按 Laravel 的「输入源优先级」）。
立即学习“PHP免费学习笔记（深入）”；
request() 和 $request->input() 的关键区别
表面相似，但来源逻辑和可扩展性差异明显：
-
request('key')是「输入快照」，调用时已合并全部来源，不响应后续修改（比如你手动改了$_POST，它不会变） -
$request->input('key')是动态代理，每次调用都重新检查当前请求实例状态；可用于单元测试中 mock 输入 - 性能上几乎无差别，但调试时
dd($request->all())比dd(request()->all())更易追踪来源 - 如果你在中间件里修改了请求内容（例如解密参数），只有注入的
$request对象能反映变更
容易被忽略的边界情况
这些点不报错，但结果不符合预期：
- GET 请求里用
request()->post('x')拿不到值——得用request()->query('x')或request('x') - 表单字段名含点号（如
user.name），request('user.name')默认不解析嵌套，要写成request('user')['name']或启用dot-notation配置 - JSON 请求体中传
{"active":null}，request('active', false)仍返回null，因为 null 不触发默认值回退——得用request()->input('active', false)才生效 - 上传文件必须用
$request->file('avatar')，request('avatar')返回空数组或 null
复杂表单、API 与 Web 共存、多层中间件修改请求时，别图省事全用 request()——显式注入 Request $request 才可控。
