\_isPost 已被彻底移除,应改用 request()->isPost() 或 method()===‘POST’;isAjax() 仅校验 X-Requested-With 头,易误判,推荐结合 header 或 content-type 判断。

ThinkPHP 5.1+ 中 _isPost 已不存在,别再查文档找它了
直接说结论:_isPost 是 ThinkPHP 3.x 时代的私有方法,在 5.x 和 6.x 中**已被彻底移除**。如果你在控制器里写 $this->_isPost(),会报 Fatal error: Uncaught Error: Call to undefined method。官方改用更明确、更可控的请求对象判断方式。
替代方案是通过请求实例的 isPost() 或 method() 方法:
-
request()->isPost()—— 判断是否为 POST 请求(不区分 AJAX) -
request()->method() === 'POST'—— 效果等价,但更底层、少一层封装 -
request()->isAjax()—— 判断是否含X-Requested-With: XMLHttpRequest头(注意:可被伪造)
isAjax() 的真实行为和常见误判场景
isAjax() 本质只检查请求头,不是“检测前端是不是用了 jQuery.ajax()”,而是看有没有 X-Requested-With 这个字段且值为 XMLHttpRequest。现代 Fetch、Axios 默认不带这个头,所以很可能返回 false,哪怕你确实是 AJAX 提交。
容易踩的坑:
立即学习“PHP免费学习笔记(深入)”;
- Vue + Axios 发起的 POST 请求,
request()->isAjax()默认为false - Postman 手动加头测试时,漏写了
X-Requested-With或拼错大小写(必须首字母大写) - Nginx / Apache 反向代理可能过滤或重写请求头,导致后端收不到该字段
- 部分移动端 WebView 或小程序环境不自动携带该头
如果业务真依赖“是否为 AJAX”,建议前端显式传自定义标识,比如 headers: { 'X-Request-Type': 'ajax' },后端用 request()->header('X-Request-Type') === 'ajax' 判断更可靠。
验证请求类型,优先用 method() + param() 组合判断意图
单纯靠 isPost() 或 isAjax() 往往不够——比如一个接口既要支持表单 POST 提交,也要支持 JSON 格式的 AJAX PUT 请求。这时候真正该关心的是「客户端想干什么」,而不是「它用什么方式发的」。
实操建议:
- 用
request()->method()获取实际 HTTP 方法(POST、PUT、DELETE) - 用
request()->param()或request()->post()区分参数来源(param合并 GET/POST/ROUTE;post仅取 POST body) - 对 RESTful 接口,直接按 method 分支处理,比套
isAjax()更清晰 - 若需兼容传统表单 + 前后端分离两种模式,可在参数中加
_type=api或检查Content-Type: application/json
示例片段:
if (request()->method() === 'POST') {
$data = request()->param(); // 兼容 ?a=1&b=2 和 JSON body
if (request()->header('content-type') === 'application/json') {
$data = json_decode(request()->getContent(), true) ?: [];
}
}
TP6 的 Validate 和中间件更适合做请求类型守门人
把 isPost() 或 isAjax() 写在每个控制器方法开头,既重复又难维护。TP6 更推荐用中间件统一拦截非法请求方式。
比如建一个 CheckRequestMethod 中间件:
- 针对 API 路由,强制要求
request()->isAjax()或指定 header - 针对后台表单路由,允许
GET(展示)和POST(提交),拒绝其他 method - 配合
Validate规则中的require_if或闭包验证,动态校验字段是否存在(如 POST 必须有token)
这样控制器就能专注业务逻辑,不用反复写判断。而且中间件可复用、可配置、可单元测试。
真正麻烦的从来不是“怎么判断”,而是“判断之后要不要放行、放行后数据格式是否一致、错误响应是否统一”。这些点一旦分散在几十个控制器里,后期改起来就全是坑。


















