讲师中心 微信公众号
AI工具推荐 视频效率加速

ThinkPHP如何替代已废弃的M方法原生查询_使用Db类链式操作技巧

夏杰同学_2786

夏杰同学_2786

发布时间:2026-04-27 10:55:38

|

1041人浏览过

|

来源于php中文网

原创

ThinkPHP 6+ 中 M() 方法已被彻底移除,原生查询必须使用 Db::table() 或 Db::name();where 条件需用数组或闭包确保安全;链式调用须遵循 SQL 从句顺序;调试应以执行日志为准,而非 fetchSql()。

thinkphp如何替代已废弃的m方法原生查询_使用db类链式操作技巧

ThinkPHP 6+ 里 M() 方法彻底没了,Db::table() 是唯一正解

ThinkPHP 6 开始,M() 方法被完全移除,不是弃用,是删了。它依赖的 Model 类底层逻辑已重构,强行找兼容层只会埋雷。现在所有原生查询必须走 Db 类,哪怕你只是查一张表、不建模型。

常见错误现象:Call to undefined function M() 或 Class 'M' not found;有人试图用 new Model() 模拟,结果连表名都自动加了前缀、字段映射错乱。

  • Db::table('user') 直接指定表名,不走模型类,无自动前缀、无字段转换,最接近旧 M('user')
  • 如果项目启用了全局表前缀(如 tp_),Db::name('user') 会自动拼前缀,而 table() 不会——这点必须手动确认配置
  • 别在 Db::table() 后调 ->find() 就以为能返回模型实例:它只返回数组,要对象得自己封装或改用 Db::name()->find() + 定义模型

where 条件写法变了,字符串条件不能直接拼 SQL

旧版 M('user')->where("id > 10 AND status = 1")->select() 这种写法在 Db 链式操作中依然可用,但风险极高:参数没过滤、SQL 注入敞口大,且 ThinkPHP 6 默认开启 PDO 预处理,字符串条件会被当字面量处理,导致语法错误。

正确做法是用数组或表达式参数,让框架帮你绑定:

立即学习“PHP免费学习笔记(深入)”;

PHP
PHP

编写健壮的PHP代码,规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载
  • 安全写法:Db::table('user')->where(['status' => 1, 'id' => ['>', 10]])->select()
  • 复杂条件用闭包:Db::table('user')->where(function ($query) { $query->where('id', '>', 10)->whereOr('status', 0); })->select()
  • 真要拼原始 SQL?用 Raw:Db::table('user')->where('id', 'IN', Db::raw('(SELECT user_id FROM tp_log WHERE type = 1)')),但 Db::raw() 必须显式调用,不能直接写字符串

join / order / group 等链式方法顺序不能乱

Db 类的链式调用不是“随便链”,执行顺序直接影响 SQL 生成。比如 order() 放在 limit() 后面,有些驱动(尤其是 SQLite)会报错;join() 如果写在 where() 之后,关联条件里的别名可能还没生效。

推荐固定顺序(按 SQL 从句自然顺序):table() → join() → where() → group() → having() → order() → limit()。这不是强制约束,但跳着链容易触发边界 bug。

  • join() 第二个参数必须是完整 ON 表达式,不能只写字段名:->join('user_profile', 'user.id = user_profile.user_id'),漏等号或空格会直接报 SQL 错误
  • order() 多字段要用数组:->order(['sort' => 'desc', 'id' => 'asc']),传字符串 'sort desc, id asc' 虽然能跑,但某些数据库驱动会忽略第二个字段
  • limit(10, 20) 表示 offset 10、count 20,和旧版 M()->limit('10,20') 语义一致,但注意参数是数字,不是字符串

调试 SQL 时别只看 ->fetchSql(),得看实际执行日志

Db::table('user')->where('id', 1)->fetchSql(true) 确实能返回 SQL 字符串,但它不经过查询构造器最终渲染,比如没展开 IN 数组、没替换绑定参数占位符,看起来像 WHERE id IN (?),实际执行却是 WHERE id IN (1,2,3)。

真正要定位问题,得开日志:

  • 配置 'log' => ['level' => ['sql']],SQL 语句会输出到 runtime/log/ 目录下,带完整参数值
  • 开发环境可临时加 Db::listen(function ($sql, $time, $explain) { dump($sql); });,但注意它捕获的是最终执行语句,含真实参数
  • 如果发现 SQL 明明写了 group() 却没生效,大概率是 select() 前漏了 field() —— ThinkPHP 6 默认只查 *,而某些数据库对 GROUP BY 严格要求 select 字段必须在 group 中出现

最常被忽略的一点:Db 类默认不开启事务,所有操作都是自动提交。如果原代码靠 M() 的多次调用隐式依赖连接状态,换成 Db 后得显式用 Db::transaction() 包裹,否则并发下数据会错乱。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

9484

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

5721

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2055

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3568

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4254

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3331

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4737

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3702

2023.11.13

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

0

2026.09.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn