CentOS PHP日志如何提高可读性

CentOS 上提升 PHP 日志可读性的实用方案

一 统一并结构化日志格式

• 在应用侧使用成熟的日志库（如 Monolog），采用**结构化格式（JSON）**输出，包含固定字段：timestamp、level、message、context、trace_id、uri、method、ip、uid/sid。示例（PHP-FPM 环境）：
  • 安装：composer require monolog/monolog
  • 配置示例：
    • use Monolog\Logger; use Monolog\Handler\StreamHandler; use Monolog\Formatter\JsonFormatter;
    • $log = new Logger(‘app’);
    • $handler = new StreamHandler(‘/var/log/php/app.log’, Logger::INFO);
    • $handler->setFormatter(new JsonFormatter());
    • $log->pushHandler($handler);
• 统一日志级别：DEBUG/INFO/WARNING/ERROR/CRITICAL/ALERT/EMERGENCY，生产环境避免 DEBUG 泛滥。
• 在 php.ini 中确保错误日志开启并指向统一位置：log_errors = On、error_log = /var/log/php_errors.log；生产环境建议 display_errors = Off，避免信息泄露到前端。
• 为便于检索，统一时间格式为 ISO8601（如：2025-11-23T10:20:30+08:00），并在日志消息中避免多行堆栈与无关噪声。

二 规范 PHP-FPM 与 Web 服务器日志

• PHP-FPM 建议输出两类日志并捕获子进程输出：
  • 在池配置（如 /etc/php-fpm.d/www.conf）中：
    • access.log = /var/log/php-fpm/access.log
    • error.log = /var/log/php-fpm/error.log
    • catch_workers_output = yes
    • php_admin_flag[log_errors] = on
    • php_admin_value[error_log] = /var/log/php-fpm/error.log
• Web 服务器日志格式建议：
  • Nginx：使用 combined 格式记录 $remote_addr、$request、$status、$body_bytes_sent、$http_referer、$http_user_agent、$request_time、$upstream_response_time，便于定位慢请求与异常状态码。
  • Apache：使用 combined 或自定义 LogFormat，包含 %h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i"。
• 统一时间与时区：在 php.ini 设置 date.timezone = Asia/Shanghai，在 Nginx/Apache 配置中统一使用本地时区，避免跨系统时间混乱。

三 日志轮转与保留策略

• 使用 logrotate 管理 PHP 与 PHP-FPM 日志，避免单文件过大、便于归档检索：
  • 新建 /etc/logrotate.d/php：
    • /var/log/php_errors.log /var/log/php-fpm/*.log {
      • daily
      • missingok
      • rotate 7
      • compress
      • delaycompress
      • notifempty
      • create 640 root adm
      • sharedscripts
      • postrotate
        • /bin/systemctl reload php-fpm > /dev/null 2>&1 || true
      • endscript
    • }
• 若使用库自带的轮转（如 RotatingFileHandler），也需与系统策略保持一致，避免重复切割或权限冲突。

四 权限安全与敏感信息控制

• 日志目录与文件权限：建议 /var/log/php/ 及日志文件属主 root:adm，权限 640，仅允许必要人员读取；Web 服务运行用户（如 nginx/apache）通过组权限写入。
• 避免记录敏感信息：不在日志中打印 密码、密钥、信用卡号、完整 SQL；必要时对 context 做脱敏（如只保留 前6后4 的手机号/身份证）。
• 生产环境务必关闭 display_errors，仅写入日志；开发环境可临时开启便于调试。

五 快速排查与可视化分析

• 命令行快速检索：
  • 按级别筛选错误：grep -E '"(ERROR|CRITICAL)"' /var/log/php_errors.log | jq .
  • 按 trace_id 串联调用链：grep 'trace_id=abc123' /var/log/php-fpm/access.log /var/log/php/app.log
  • 统计 5xx 与上游耗时：awk '$9 >= 500 {count++; sum+=$NF} END {print "5xx:", count, "avg_time:", sum/count}' /var/log/php-fpm/access.log
• 集中化与可视化：将 JSON 日志接入 ELK Stack（Elasticsearch + Logstash + Kibana） 或 Grafana Loki，配置索引与 Kibana Dashboard，实现按 level、uri、status、trace_id 的聚合分析与告警。