线上问题的特点是:不可复现、用户描述模糊、你只有几分钟时间定位。这时候唯一能依靠的就是日志。日志设计得好不好,直接决定排查是十分钟还是十小时。
至少要记录的四类日志
| 类型 | 内容 | 用途 |
|---|---|---|
| 访问日志 | URL、状态码、耗时、IP、UA | 看流量与异常请求 |
| 错误日志 | PHP 错误、异常堆栈 | 定位代码问题 |
| 业务日志 | 关键操作:下单、支付、退款 | 对账与纠纷处理 |
| 慢日志 | 耗时超过阈值的请求或 SQL | 性能优化依据 |
结构化比好看更重要
用 JSON 行格式,方便 grep 和导入分析工具。关键是每条日志都带请求 ID,这样能把一次请求涉及的所有日志串起来。
<?php
$traceId = $_SERVER['HTTP_X_REQUEST_ID'] ?? bin2hex(random_bytes(8));
function logInfo(string $msg, array $ctx = []): void
{
global $traceId;
$line = json_encode([
'time' => date('c'),
'level' => 'info',
'trace' => $traceId,
'uri' => $_SERVER['REQUEST_URI'] ?? '',
'msg' => $msg,
'ctx' => $ctx,
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
error_log($line);
}
Nginx 日志加耗时
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" rt=$request_time urt=$upstream_response_time';
rt 是总耗时,urt 是 PHP 处理耗时。两者差距大,说明瓶颈在网络或 Nginx;urt 本身大,才是 PHP 慢。
日志轮转
日志不轮转,迟早撑爆磁盘。用 logrotate 按天切割并保留 14 天:
/www/wwwlogs/*.log {
daily
rotate 14
missingok
notifempty
compress
delaycompress
sharedscripts
postrotate
/bin/kill -USR1 $(cat /var/run/nginx.pid 2>/dev/null) 2>/dev/null || true
endscript
}
监控什么
不需要一上来就上全套 APM。先盯住四个指标:5xx 比例、平均响应时间、磁盘使用率、数据库连接数。任何一个异常,都值得立刻查。可以用简单的定时脚本 + 邮件/微信通知,成本很低但很有效。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。