PDO层捕获慢查询需主动测量SQL执行耗时，用microtime(true)计时、还原真实SQL、按阈值记录日志，并区分环境开关，再与MySQL慢日志交叉验证定位根因。
要在 PDO 层捕获慢查询并记录 SQL 执行耗时，关键不是等 MySQL 慢日志反馈，而是让 PHP 主动测量每条语句的真实执行时间，并结合上下文（如 URL、用户、IP）打点记录。这样既能定位到具体哪条语句慢，又能关联业务逻辑，避免“知道慢、但不知道谁在调用”。
手动封装执行方法，嵌入计时逻辑
不依赖外部中间件或 APM 工具时，最直接有效的方式是统一收口数据库调用，用函数或类封装 prepare + execute 流程，在前后插入 microtime(true) 计算耗时：
- 用 microtime(true) 获取高精度起始时间，执行完再取一次，差值即为秒级耗时（可乘以 1000 转毫秒）
- 将耗时、原始 SQL、绑定参数、当前脚本路径、请求方法等一并写入日志（推荐 error_log 或 Monolog）
- 设置阈值（例如 >200ms 视为慢查询），只记录超时语句，避免日志爆炸
记录完整可执行 SQL（含参数值），便于复现与比对
MySQL 慢日志里看到的是带 ? 或 :name 的模板，而 PDO 日志若只记模板，无法直接复现或 EXPLAIN。必须还原成真实语句：
- 对问号占位符：用 vsprintf + addslashes 处理字符串参数（注意非字符串类型不加引号）
- 对命名占位符：先替换键名（如 :id → ?），再统一走 vsprintf 流程，或遍历 params 数组逐个替换
- 示例片段：error_log(sprintf('[SLOW %dms] %s', $ms, $realSql));
区分环境，避免影响线上性能
计时和拼接真实 SQL 都有轻微开销，生产环境需控制粒度：
立即学习“PHP免费学习笔记（深入）”；
- 开发/测试环境：全量记录，包括所有查询和参数
- 预发/线上环境：仅记录超过阈值的慢查询；禁用真实 SQL 拼接（或仅对慢查询启用）
- 可通过配置项开关，如 DB_LOG_SLOW_MS = 300，动态生效
配合 MySQL 慢日志做交叉验证
PDO 层日志解决“哪段 PHP 代码触发了慢 SQL”，MySQL 慢日志解决“这条 SQL 为什么慢”。两者结合才完整：
- 开启 MySQL 的 slow_query_log 和 long_query_time=0.3
- 确保 MySQL 记录的是未格式化的原始语句（set log_output = 'FILE';），方便与 PDO 日志中的 realSql 字符串比对
- 发现某条语句在 PDO 层耗时 420ms、MySQL 日志也记录为 410ms → 基本确认是 SQL 自身问题（缺索引、临时表等）
