最稳妥做法是在echo json_encode(...)前用error_log()或file_put_contents()记录原始数据，注意过滤敏感字段、添加时间戳和换行，并校验json_last_error()确保编码成功。
PHP 返回 JSON 前怎么把数据写入日志
直接在 echo json_encode(...) 之前记录日志是最稳妥的做法——此时数据还是原始数组/对象，没经过编码转换，结构清晰、可读性强，也避免了 JSON 解码失败带来的额外麻烦。
常见错误是等 echo 完再试图从输出缓冲里抓 JSON 字符串去记录，不仅多一层 decode 风险，还可能被 header、gzip、中间件等干扰，日志内容错乱或为空。
- 用
error_log()或file_put_contents()写入，注意加换行和时间戳：error_log(date('Y-m-d H:i:s') . " [API] " . json_encode($data, JSON_UNESCAPED_UNICODE) . "\n", 3, '/var/log/php_api.log'); - 若数据较大或含敏感字段（如
password、token），务必先unset()再记录，别图省事全量打日志 - 生产环境避免用
print_r($data, true)替代json_encode()，前者格式不标准、不易被日志系统解析
为什么不能只记录 $_SERVER['REQUEST_URI'] 和响应状态码
URI 和状态码只能说明“谁访问了什么路径”以及“是否返回了 200”，但完全无法还原“返回了什么数据”。调试时最常遇到的问题是：前端说“没拿到 user.name”，后端查日志发现请求确实进了，状态码也是 200，但不知道 $data['user']['name'] 是 null、空字符串，还是压根没塞进去。
- 仅记录请求参数（
$_GET/$_POST）也不够——逻辑可能依赖数据库查询结果或外部 API 调用，输入对不代表输出对 - 如果接口有多个分支（如不同
if条件返回不同结构），不记实际返回体，就无法确认走的是哪条路径 - 某些框架（如 Laravel）的响应对象需显式调用
getContent()才能拿到最终 JSON 字符串，直接var_export($response)可能只打印对象元信息
JSON 日志怎么避免性能和安全问题
高频接口每请求都全量记录原始 JSON，磁盘 I/O 和日志体积会迅速失控；同时，未过滤的用户输入直接进日志，可能埋下 XSS 或日志注入隐患（比如换行符 + %0a 伪造日志条目）。
立即学习“PHP免费学习笔记（深入）”；
- 按环境开关日志：开发/测试环境全量记录，生产环境只记录
error级别或特定接口（如strpos($_SERVER['REQUEST_URI'], '/api/v1/order') !== false） - 用
json_encode($data, JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_UNESCAPED_UNICODE)防止因 NaN、资源类型等导致编码失败中断流程 - 对日志内容做基础清洗：用
str_replace(["\r", "\n"], ' ', $log_line)消除换行，避免日志切割错位 - 敏感键名统一过滤（如遍历数组递归 unset
password、auth_token、id_card等）
用 Monolog 记录 JSON 响应要注意什么
Monolog 默认把上下文数组当结构化数据处理，但直接传 json_encode() 后的字符串进去，它会再套一层 JSON，导致日志里出现双重转义（如 "{"code":0}"），排查时得手动解两次。
- 正确做法是传原始数组，并指定
JsonFormatter：$handler = new StreamHandler('/var/log/api.json', Logger::INFO);<br>$handler->setFormatter(new JsonFormatter());<br>$logger = new Logger('api');<br>$logger->pushHandler($handler);<br>$logger->info('response', $data); // $data 是数组，不是 json_encode 后的字符串 - 若必须记录已编码的 JSON 字符串，请改用
LineFormatter并关闭 JSON 转义：$formatter = new LineFormatter(null, null, false, true);
- Monolog 的
RotatingFileHandler在高并发下可能因文件锁导致写入延迟，简单接口建议用StreamHandler+ 外部日志轮转（如 logrotate）
null 或空字符串——加个 if (json_last_error() === JSON_ERROR_NONE) 判断，比事后翻三天日志更省时间。 
