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