PHP 实用教程:手写一个 PDO 数据访问层,把 SQL 注入和事务翻车挡在外面

举报
yd_250740708 发表于 2026/11/17 14:26:49 2026/11/17
【摘要】 一、先说清这篇教程解决什么问题PHP 项目里最好写的数据库代码,往往最危险。一边是 mysql_query 式的裸拼字符串,一年后没人敢改;另一边是一上来就塞 Laravel Eloquent,为了查三条数据装进一整个框架。中间那条路——用 PDO 自己封一层薄薄的数据访问层——反而被跳过了。这篇教程就干这件事:从零写一个 Db 类,约 200 行,解决五件事:预处理语句真正生效,' OR ...

一、先说清这篇教程解决什么问题

PHP 项目里最好写的数据库代码,往往最危险。

一边是 mysql_query 式的裸拼字符串,一年后没人敢改;另一边是一上来就塞 Laravel Eloquent,为了查三条数据装进一整个框架。中间那条路——用 PDO 自己封一层薄薄的数据访问层——反而被跳过了。

这篇教程就干这件事:从零写一个 Db 类,约 200 行,解决五件事:

  1. 预处理语句真正生效,' OR 1=1 -- 打不进来;
  1. 事务能嵌套,内层失败不会把外层脏数据提交;
  1. IN (...) 查询和批量插入不用手拼占位符;
  1. 查询结果类型正确,id 是 int 不是字符串;
  1. 出问题时能定位到具体 SQL 和参数。

代码基于 PHP 8.1+(用到 match、readonly、命名参数),MySQL 5.7/8.0 均可。文中会反复踩三个坑,都是真上线后才会疼的那种。


二、环境与目录

目录结构保持最小:

composer.json 只做一件事:注册 PSR-4 自动加载,不必引入任何第三方包。

执行 composer dump-autoload 生成 vendor/autoload.php。如果你不想用 Composer,后面会给出替代的 spl_autoload_register 写法。

配置文件用数组返回,方便不同环境覆盖:

密钥从环境变量读,不写进代码仓库——这条比后面所有优化都重要。


三、第一版:最朴素的封装,以及它埋的三个坑

先看大多数人会写出的版本:

这段代码看起来用了预处理,很多人就放心了。但把它当成数据访问层的全部,会漏掉三个坑。

坑一:模拟预处理,等于没有预处理

PDO 的 ATTR_EMULATE_PREPARES 默认值在不少环境下是 true。这意味着 PDO 不会把 SQL 和参数分别发给 MySQL,而是在客户端做字符串转义拼接,然后发一条普通 SQL 过去。

一句话说清区别:

  • 模拟预处理:PHP 负责转义 → 参数值仍可能参与 SQL 语法解析;
  • 原生预处理:SQL 模板先到 MySQL 编译好 → 参数只能当值,永远进不了解析器。

少数编码相关的注入场景(如历史上的 GBK 宽字节问题)在模拟预处理下依然有风险。另外它还有个副作用:查出来的整数全变成字符串。

修法只有一行:

坑二:IN 查询的占位符不能这么拼

IN 里的占位符必须按元素个数生成,不是塞一个 ? 就完事。

坑三:事务嵌套,内层失败外层照提交

PDO 原生不支持嵌套事务。业务代码一分层,服务层开事务、仓储层也开事务,就撞上了。MySQL 本身提供了 SAVEPOINT,用它实现软嵌套即可。


四、完整实现:src/Support/Db.php

下面是可以直接落地的版本,逐段解释。

final + 私有构造 + 静态单例,是为了让连接在整个请求周期只建一次。ATTR_PERSISTENT 显式关掉,理由后面单列一节。

4.1 参数绑定:类型必须自己判断

这里有个容易忽略的细节:execute($params) 会把所有参数按字符串处理,LIMIT 后的 ? 传 '10' 在原生预处理下会报 Incorrect arguments to mysqld_stmt_execute。手动 bindValue 带类型,是绕开这个问题的正解。

float 会被当作字符串传,MySQL 侧会隐式转换,一般没问题;但涉及金额比较时,建议在应用层用整数分表示,别指望数据库替你保精度。

4.2 查询方法族

one() 返回 ?array 而不是 false,是为了让调用方的 if ($row === null) 语义清晰,fetch() 失败返回的 false 不会被误当成数组用。

4.3 IN 查询:占位符按个数生成

调用方这样写:

顺带一个容易被忘的点:array_values 不能省。如果传进来的是 ['a'=>1,'b'=>2] 这种关联数组,? 是按位置绑的,键名一乱就错位。

4.4 批量插入:分块 + 字段校验

分块的目的是避开两个上限:max_allowed_packet(默认 64MB,但小配机器会调低)和预处理语句的参数个数上限(65535)。500 行 × 20 列 = 10000 个参数,留了余量。

表名和字段名是拼接进去的——它们必须来自你的代码,绝不能来自用户输入。这是拼接类 SQL 唯一的合法场景。

4.5 事务嵌套:用 SAVEPOINT 做软嵌套

行为的精确语义,值得逐条记住:

  • 第 0 层失败 → 整个事务回滚;
  • 第 1 层失败 → 只回滚到 sp1,第 0 层后续操作仍可提交;
  • 异常一律继续抛出,不吞掉。吞异常是事务封装最常见的错误,它会让上层以为成功。

4.6 分页与日志

LIMIT 这里是整数内插。原因很实在:原生预处理下 LIMIT ?, ? 必须严格绑定 PARAM_INT,稍有疏漏就报错;而 $page、$size 已经过 int 强制转型,注入面为零。性能上内插还少一次预处理,翻页接口这种高频查询值得。

COUNT 用子查询包一层,是为了兼容原 SQL 里的 GROUP BY、DISTINCT——直接替换 SELECT 列表会在这些场景下算错。


五、跑一个完整例子

建表:

demo.php:

不用 Composer 的话,把 vendor/autoload.php 换成这行:

substr($class, 4) 是砍掉 App\ 前缀,长度随命名空间变化,记得同步改。


六、验证注入确实打不进来

写代码时自信,不如跑一次证明。用 sqlmap 或手工请求都行,最省事的是手工:

如果查询里的 id 走的是本文的 run(),MySQL 收到的是一条参数化语句,1 OR 1=1 会被完整当作一个字符串值去和 id 比较,返回空结果,不会返回全表。

判断方法看日志:打开 MySQL 通用查询日志,或用 Db::logs()。看到的是 WHERE id = ? 而不是 WHERE id = '1 OR 1=1',才算真的走对了路。

反过来说,如果你在日志里看到 ATTR_EMULATE_PREPARES 为 true 时那种已经拼好的 SQL,那前面的所有努力都白做。


七、长连接该不该开

ATTR_PERSISTENT => true 能让 FPM 子进程复用连接,省掉握手。但它在 PHP 里有两个真实代价:

  1. 连接状态会跨请求残留。上一个请求如果忘了提交或回滚,事务上下文会带到下一个请求,表现为「莫名查不到刚插入的数据」或「莫名锁等待」。这就是代码里 ATTR_PERSISTENT => false 的原因。
  1. 连接数不好预估。pm.max_children 是多少,就可能长期占住多少 MySQL 连接。

正确做法不是开长连接,而是在 FPM 层做两件事:

pm.max_requests 是防内存泄漏和连接泄漏的兜底,成本几乎为零。真需要连接池,思路应该指向代理层(如 ProxySQL)或常驻进程(Swoole / RoadRunner),而不是在 FPM 里硬开持久连接。


八、性能怎么自测,别信口口相传的结论

网上关于「预处理慢不慢」「批量插入快多少」的结论,九成没有说清测试条件。自己测最省事:

测试时务必固定三件事,否则数字没有可比性:

  • 同一台机器、同一个 MySQL 实例;
  • 第一次运行要丢弃(预热,缓冲池还没热);
  • 每项至少跑 5 轮取中位数,别看单次。

这里刻意不给具体数字。预处理的性能差异与网络往返、表结构、索引命中率、MySQL 版本强相关,抄来的数字到了你的机器上大概率失效。在自己目标机器上按上面的方法测一遍,比抄任何结论都靠谱。


九、什么时候该换 ORM

这层封装不是万能的。出现下面任一情况,就该考虑上 ORM 或查询构建器:

场景

建议

模型关系复杂(一对多、多对多,需自动关联)

Eloquent / Doctrine

团队多人维护,需要统一的模型约束

Doctrine(Data Mapper 思路更稳)

简单 CRUD 为主、SQL 可读性优先

本文这层足够,别过度设计

报表、统计、多表聚合

手写 SQL,任何 ORM 在这里都是负担

判断标准其实只有一条:你的查询是「以数据为中心」还是「以对象为中心」。前者手写 SQL 更快更清楚,后者才需要 ORM。


十、小结

回到开头那三个坑,这条数据访问层做的事情其实很朴素:

  • 用 ATTR_EMULATE_PREPARES => false 让预处理真的在数据库侧编译;
  • 用 bindValue 带类型绑定,避开 execute() 全字符串化的陷阱;
  • 用 SAVEPOINT 给事务加上软嵌套,配合「异常必抛」的纪律;
  • 用 whereIn 与 insertBatch 把最容易手拼 SQL 的两个地方收口;
  • 用 logs() 让每条 SQL 可追溯。

两百行不到,但它把「安全」和「可维护」两件事同时收在了代码层,而不是靠开发者每次都记得。

留个自检题:如果你的 whereIn 收到空数组,现在的实现是 IN (NULL),查询返回 0 行。这个行为符合你的业务预期吗?换成「空数组直接短路返回 [],不发 SQL」会不会更省一次数据库往返?想清楚这一点,你就知道这层封装该往哪个方向长。


说明:本文代码按 PHP 8.1+ / MySQL 8.0 语法逐行核对;写作环境无 PHP 运行时,未做本机实跑,请在目标环境跑一遍再上生产。生产使用前另需补充连接超时、慢查询告警与敏感参数脱敏。表结构与索引只作演示,实际应结合执行计划 EXPLAIN 复核。

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。