线上问题的特点是:不可复现、用户描述模糊、你只有几分钟时间定位。这时候唯一能依靠的就是日志。日志设计得好不好,直接决定排查是十分钟还是十小时。

至少要记录的四类日志

类型 内容 用途
访问日志 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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。