PHP 8.3 接口日志需统一入口拦截、结构化JSON输出、全链路trace_id串联，并在关键位置补全异常、SQL、第三方调用等上下文，配合分级轮转避免磁盘爆满。
PHP 8.3 中记录接口日志，核心是在请求入口统一拦截、结构化输出、关联上下文，避免散落的 error_log() 或 var_dump()。重点不是“用什么函数”，而是“在哪记、记什么、怎么查”。
一、用中间件或前置钩子统一捕获请求
不要每个接口手动加日志。推荐在框架（如 Laravel、Slim）的中间件，或原生 PHP 的入口文件（如 index.php）最开始处做统一处理：
- 记录时间戳、HTTP 方法、完整 URL（含 query）、客户端 IP、User-Agent
- 读取并记录原始请求体（
file_get_contents('php://input')），注意 POST/PUT/DELETE 等非表单请求 - 对 JSON 请求自动解析并美化记录（但别记敏感字段，如 password、token）
二、结构化日志格式，方便 grep 和 ELK 分析
别用纯文本拼接。用 JSON 格式写入日志文件，每行一个 JSON 对象：
{
"time": "2024-05-20T14:22:35+08:00",
"method": "POST",
"uri": "/api/v1/users",
"ip": "192.168.1.100",
"status": 201,
"duration_ms": 127.4,
"req_body": {"name": "张三", "email": "zhang@example.com"},
"trace_id": "abc123xyz"
}PHP 写法示例：
立即学习“PHP免费学习笔记（深入）”；
$log = [
'time' => date('c'),
'method' => $_SERVER['REQUEST_METHOD'] ?? '',
'uri' => $_SERVER['REQUEST_URI'] ?? '',
'ip' => $_SERVER['REMOTE_ADDR'] ?? '',
'status' => $httpStatus,
'duration_ms' => round((microtime(true) - $startTime) * 1000, 1),
'req_body' => $cleanRequestBody, // 已脱敏
'trace_id' => $_SERVER['HTTP_X_TRACE_ID'] ?? bin2hex(random_bytes(6))
];
file_put_contents('/var/log/myapp/api.log', json_encode($log, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . "\n", FILE_APPEND | LOCK_EX);三、关键位置补全日志线索
光有请求头不够，排查时还需知道“执行到哪了、为什么失败”：
- 在 try/catch 的
catch块里记录异常：错误消息、文件行号、堆栈（用getTraceAsString()，但建议截断前 10 行防日志过大） - 数据库查询慢？在 PDO 或 MySQLi 执行前后打点，记录 SQL（脱敏参数）、执行耗时、影响行数
- 调用第三方 API？记下请求 URL、headers（不含 Authorization）、响应状态码和 body 片段（如前 200 字符）
- 给每条日志加
trace_id，前端传入则复用，否则服务端生成并返回给前端，便于全链路串联
四、日志分级与轮转，避免磁盘爆满
PHP 8.3 原生支持 error_log() 配合 syslog 或自定义 handler，但更推荐轻量方案：
- 用
Monolog（v3+ 支持 PHP 8.3）：配置RotatingFileHandler按天/大小切分，自动压缩旧日志 - 禁用
display_errors = On，防止错误直接输出到页面；所有错误统一走日志，不暴露细节给用户 - 调试阶段可临时开启
log_errors = On+error_log = /var/log/php_errors.log，但生产环境只记录 WARNING 及以上
