使用Monolog记录结构化日志，统一JSON格式并包含请求响应信息，通过Filebeat或Kafka将日志集中至ELK平台，实现高效分析与错误告警，提升问题定位效率。
调试 PHP 接口并集中收集日志，关键在于记录请求与响应信息、统一日志格式、集中存储与分析。下面从开发调试到生产环境的日志收集与分析，给出实用方法。
1. 在接口中添加结构化日志输出
开发阶段或线上调试时，先确保每个接口能输出清晰、结构化的日志。建议使用 PSR-3 兼容的日志库（如 Monolog），避免直接用 var_dump() 或 error_log()。
- 安装：composer require monolog/monolog
- 在入口文件或控制器中初始化：
$logger = new \Monolog\Logger('api');
$logger->pushHandler(new \Monolog\Handler\StreamHandler('/logs/api.log', \Monolog\Logger::DEBUG));
// 记录请求
$logger->info('API Request', [
'uri' => $_SERVER['REQUEST_URI'],
'method' => $_SERVER['REQUEST_METHOD'],
'ip' => $_SERVER['REMOTE_ADDR'],
'params' => $_REQUEST,
'user_id' => $userId ?? null
]);
// 接口处理后记录响应
$logger->info('API Response', ['status' => 'success', 'data' => $responseData]);
2. 统一日志格式便于后续分析
日志内容应包含时间、级别、接口路径、客户端IP、参数摘要、执行耗时、状态等字段。推荐使用 JSON 格式，方便机器解析。
- 记录执行时间：
$start = microtime(true); ... $cost = microtime(true) - $start; - 异常捕获并记录堆栈：
try {
// 接口逻辑
} catch (Exception $e) {
$logger->error('API Error', [
'message' => $e->getMessage(),
'trace' => $e->getTraceAsString()
]);
}
3. 集中收集日志到日志服务器
单机日志不利于排查问题，应集中收集。常用方案：
立即学习“PHP免费学习笔记（深入）”；
- Filebeat + ELK（Elasticsearch, Logstash, Kibana）：将本地日志文件通过 Filebeat 发送到 Logstash 处理，存入 ES，用 Kibana 查看。
- Syslog / Rsyslog：配置 PHP 写日志到 syslog，再由 rsyslog 转发到中心服务器。
- Kafka + Logstash：高并发场景下，PHP 将日志推送到 Kafka，异步消费处理。
在关键 log 后追加：
@file_get_contents("http://logserver/receive.php?data=" . urlencode(json_encode($logData)));
注意：异步发送避免影响主流程，可用 fsockopen 或后台脚本转发。
4. 分析与告警
集中日志后，可通过以下方式提升排查效率：
- 在 Kibana 中按接口、IP、状态码过滤，查看调用趋势。
- 设置错误日志告警（如5xx频率突增）。
- 关联用户行为：结合 user_id 或 trace_id 实现链路追踪。
- 敏感数据脱敏：记录参数时过滤 password、token 等字段。
基本上就这些。关键是让日志可读、可查、可追踪。开发时用 Monolog 打好基础，上线后接入集中平台，问题定位会快很多。
