真正的数据库抽象层是在PDO之上封装统一接口，强制参数绑定、异常模式、关联数组获取，并通过事务管理、驱动适配和调试支持收敛不确定性、固化安全习惯、暴露可控扩展点。
PHP PDO 本身已是数据库抽象层，但直接使用 PDO 对象容易导致 SQL 注入风险、事务管理混乱、错误处理缺失和代码重复。真正实用的抽象层不是替代 PDO，而是在其之上封装统一接口、约束行为、注入安全策略。
封装连接与配置管理
避免在业务逻辑中硬编码 DSN、用户名或密码。应将数据库配置独立为可环境切换的数组，并通过工厂模式生成 PDO 实例，同时统一设置关键属性：
- 默认开启 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，让错误抛出异常而非静默失败
- 强制设置 PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC，避免字段索引混淆
- 根据需求启用 PDO::ATTR_EMULATE_PREPARES => false（尤其 MySQL），确保预处理真实由数据库执行
- 连接复用时注意 PDO::ATTR_PERSISTENT => true 的副作用，如事务未提交可能导致后续请求复用脏状态
构建安全的查询执行器
不暴露 raw PDOStatement 或 execute() 方法。提供语义化方法，强制参数绑定：
- select(string $sql, array $params = [])：只允许 SELECT，返回关联数组列表
- fetch(string $sql, array $params = [])：返回单行（或 null）
- insert(string $sql, array $params = [])：返回 lastInsertId()
- update(string $sql, array $params = [])：返回影响行数，可校验是否为 0（更新失败）
- 所有方法内部调用 prepare() → bindParam() → execute()，禁止拼接 SQL 字符串
事务与上下文生命周期控制
事务不应由业务方法自行 begin/commit/rollback，而应交由执行器统一管理：
立即学习“PHP免费学习笔记（深入）”；
- 提供 transaction(callable $callback) 方法，在 try/catch 中自动 commit 或 rollback
- 支持嵌套事务（通过保存点 SAVEPOINT 实现），避免外层事务被内层异常意外中断
- 执行器持有当前连接状态，同一请求中多次调用 select() 应复用连接，但需明确区分“只读连接池”与“读写连接池”场景
- 避免在事务中混用不同数据库类型（如 MySQL + PostgreSQL），抽象层可检测并报错
可扩展的驱动适配与调试支持
虽 PDO 统一了 API，但各数据库语法差异仍存在（如 LIMIT/OFFSET、INSERT ON DUPLICATE KEY）。抽象层应留出钩子：
- 按 driver name（mysql、pgsql、sqlite）动态加载方言类，处理分页、插入冲突等特有语法
- 启用调试模式时，记录完整 SQL、绑定参数、执行耗时、影响行数，输出为结构化日志而非 echo
- 支持拦截 query 执行前的事件（如自动添加 tenant_id 条件）、执行后的结果转换（如时间戳转 DateTime 对象）
- 不强制 ORM 功能，但预留 hydrate() 方法，方便上层映射到 DTO 或 Entity
真正的数据库抽象不在于屏蔽所有差异，而在于收敛不确定性、固化安全习惯、暴露可控扩展点。PDO 是基石，设计得当的封装才是生产力杠杆。
