ThinkPHP5 Request 对象常用方法全解

准备工作：初始化Request对象

在进行任何操作前，首先需要获取Request实例。ThinkPHP5提供了两种等效方式：

1. 使用类静态方法：$request = Request::instance();
2. 使用助手函数：$request = request();

以下所有方法调用均基于已初始化的 $request 对象。

第1步：获取当前URL与路径信息

此步骤适用于需要分析或重构当前页面地址的场景，例如生成绝对链接、判断伪静态后缀或获取入口文件路径。

• 基础域名与入口：
  • $request->domain()：获取当前完整域名。
  • $request->baseFile()：获取当前入口文件名（通常是 index.php）。
• URL 结构与路径：
  • $request->url()：获取当前URL地址，不含域名（如 /index/index/index）。
  • $request->url(true)：获取包含域名的完整URL地址。
  • $request->baseurl()：获取URL地址，但不包含 QUERY_STRING（即问号后的参数）。
  • $request->root()：获取URL访问的ROOT地址。若传入参数 true，则包含域名。
  • $request->pathinfo()：获取URL中的 PATH_INFO 信息。
  • $request->path()：获取PATH_INFO信息，但会自动去掉文件后缀。
  • $request->ext()：单独获取URL地址中的文件后缀信息。

第2步：获取请求基本属性与通用参数

此步骤用于判断请求来源、类型以及批量获取前端提交的混合数据。

• 请求元数据：
  $request->method() 返回请求方法（GET/POST/PUT等）；
  $request->type() 返回Accept头定义的媒体资源类型；
  $request->ip() 获取访问者的真实IP地址；
  $request->isAjax() 判断是否为AJAX请求，返回布尔值。
• 通用参数获取：
  $request->param() 获取所有输入参数（自动合并GET和POST）。可通过数组筛选特定字段：
  - $request->only(['name'])：仅返回指定字段的参数。
  - $request->except(['name'])：排除指定字段的参数。

第3步：精准获取 GET/POST/COOKIE 及文件信息

当需要区分数据来源时，使用以下专用方法更安全、清晰：

• 单一参数获取：
  - $request->get('name')：专取 GET 参数。
  - $request->post('name')：专取 POST 参数。
  - $request->cookie('name')：专取 COOKIE 值。
• 文件上传处理：
  $request->file('image')：获取名为 image 的文件上传对象，后续可调用 move() 等方法保存文件。
• 任意位置参数：
  $request->param('name')：无论参数来自 GET、POST 还是 URL 路径，都会尝试获取该名称的值。

第4步：获取控制器信息与路由状态

此步骤常用于调试或动态控制逻辑，需了解当前请求由哪个模块、控制器和方法处理。

• MVC 信息提取：
  - $request->module()：获取当前模块名。
  - $request->controller()：获取当前控制器名。
  - $request->action()：获取当前操作方法名。
• 路由与调度调试：
  - $request->routeInfo()：转储当前的路由匹配详细信息。
  - $request->dispatch()：获取当前的调度信息对象。

以上就是ThinkPHP5中Request请求对象大全的详细内容，更多关于ThinkPHP5 Request参数处理的资料请关注本站其它相关文章！