PHP数据库操作日志记录技巧

PHP数据库操作日志记录的关键在于精准拦截SQL执行过程并安全、高效地持久化关键信息（如脱敏后的SQL语句、执行耗时、绑定参数、影响行数及错误详情），而非简单堆砌调试输出；推荐方案包括：基于PDO的封装类实现统一埋点、利用Laravel等框架的QueryExecuted事件进行结构化日志采集、启用MySQL general_log仅作临时调试，或在无框架项目中通过轻量级函数钩子集中管控——所有方式均需兼顾参数脱敏与非阻塞写入，以保障生产环境的安全性与性能稳定性。

PHP 中记录数据库操作日志，核心在于拦截 SQL 执行过程并持久化关键信息（如 SQL 语句、执行时间、参数、影响行数、错误信息等），而不是简单地在每个 query() 前后加 echo。推荐方式是通过封装数据库访问层或利用现有扩展机制实现统一日志埋点。

使用 PDO 封装类统一记录

继承或包装 PDO 或 PDOStatement，在 prepare()、execute()、fetchAll() 等关键方法中插入日志逻辑：

• 记录完整 SQL（含绑定参数替换后的结果，可用 PDO::ATTR_EMULATE_PREPARES = true 配合正则/函数安全拼接）
• 用 microtime(true) 计算执行耗时
• 捕获 $pdo->errorInfo() 或 $stmt->errorInfo() 获取错误详情
• 将日志写入文件、Syslog 或队列（避免阻塞主流程）

借助 MySQL general_log（仅限开发/调试）

MySQL 自带的通用查询日志可记录所有客户端发送的语句，适合快速排查，但不推荐生产环境长期开启：

• 临时启用：SET GLOBAL general_log = 'ON'; SET GLOBAL log_output = 'TABLE';
• 日志存于 mysql.general_log 表，可通过 SQL 查询最近操作
• 性能开销大，且无法区分 PHP 应用上下文（如用户 ID、请求 ID）

集成 PSR-3 日志器 + 数据库中间件（现代框架常用）

在 Laravel、ThinkPHP、Hyperf 等框架中，数据库组件通常支持事件监听或中间件机制：

• Laravel：监听 Illuminate\Database\Events\QueryExecuted 事件，获取 $event->sql、$event->bindings、$event->time
• Hyperf：通过 DbEvent 或自定义 QueryLogger 实现
• 日志内容可结构化（JSON 格式），方便 ELK 收集与分析

轻量级函数钩子（适用于无框架项目）

若无法重构 DB 层，可在基础函数中嵌入日志调用：

• 定义统一的 db_query($sql, $params = []) 函数，内部执行前记录 SQL 和参数，执行后记录耗时与结果
• 对 mysqli 使用 mysqli_prepare() → mysqli_stmt_bind_param() → mysqli_stmt_execute() 流程做包裹
• 注意敏感字段脱敏（如密码、token 字段值应替换为 [hidden]）

理论要掌握，实操不能落！以上关于《PHP数据库操作日志记录技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！