PHP-FPM 高并发日志性能优化指南

在高并发场景下，日志写入往往是制约 PHP-FPM 性能的隐形杀手。本指南从底层的服务器硬件到上层的应用框架，提供全链路的日志性能优化策略。

1. 服务器硬件与操作系统层 (OS Level)

最底层的物理限制往往决定了性能上限。

• 磁盘 I/O (Disk I/O):

  • SSD 必选: 机械硬盘的随机写入（Random Write）性能极差，高并发必须使用 NVMe SSD。
  • RAID 0/10: 使用 RAID 0 或 RAID 10 提升写入吞吐量。
  • 独立磁盘: 将日志目录（/var/log 或应用 runtime）挂载到独立的物理磁盘，避免与数据库或系统交换分区争抢 I/O。

• 文件系统 (File System):

  • XFS / Ext4: 推荐使用 XFS，在处理大文件和并发写入时性能更优。
  • noatime: 挂载磁盘时加上 noatime 选项（mount -o noatime ...），避免每次读取文件都更新访问时间，减少元数据写入。

• 内存缓冲区 (Page Cache):

  • Linux 默认会将可用内存用作磁盘缓存。确保服务器有足够的剩余内存，让操作系统替你抗住突发的写入峰值。

2. Nginx 层

尽管 Nginx 不直接处理 PHP 日志，但它的相关配置会影响整体 I/O。

• 关闭非必要日志:

  • access_log off;: 如果不需要 Nginx 访问日志（例如已经有了完善的 PHP 业务日志或 CDN 日志），直接关闭。

• Buffer 写入: 如果必须开启，使用 buffer 模式：

    access_log /var/log/nginx/access.log main buffer=32k flush=5s;
  

  这会在内存积攒 32k 或每隔 5 秒才写一次盘，极大减少 IOPS。

3. PHP-FPM 层

• 慢日志 (Slow Log):

  • 仅在排查问题时开启 request_slowlog_timeout。生产环境若无性能问题，建议关闭，因为记录堆栈信息开销巨大。

• Catch Workers Output:

  • catch_workers_output = no (默认): 除非你要用 stdout 方案，否则保持关闭。让 PHP 进程直接写文件比通过管道传给 FPM 主进程再写文件效率更高（少一次上下文切换和数据拷贝）。

4. PHP 语言层

• OpCache: 开启 OpCache 是必须的，确保代码（包括日志处理类）不需要重复编译。

5. Yii2 框架层 (最为关键)

应用层的优化往往能带来数量级的提升。

5.1 异步写入 (Asynchronous Logging) - 终极方案

不要让 PHP 进程等待磁盘 I/O。

• 方案 A: 队列缓冲 (Redis/Kafka)

  • 原理: Yii::info() -> 推送 Redis List (内存操作, <1ms) -> 结束请求。
  • 消费者: 单独起一个 Go 程序或 PHP CLI 脚本消费 Redis，批量写入磁盘。
  • 优点: 彻底解耦 I/O，接口响应极快。
  • 实现: 自定义一个 RedisTarget 继承 yii\log\Target。

• 方案 B: 内存缓冲队列 (ZeroMQ)

  • 类似于 Redis，但使用 ZeroMQ 不需要中心化的 Redis 服务，直接进程间通讯。

⚠️ ZeroMQ php版本很久没有维护了。

5.2 延迟刷盘 (Buffer Flushing)

如果你坚持直接写文件，必须调整缓冲策略。

• 增大 exportInterval:

  • 默认是 1000。
  • 在高并发下，可以保留此值或适当增大。它的含义是：积攒 1000 条日志消息后，才调用一次 Target::export()。
  • 注意: 这只是减少了 PHP Logger 对象的分发次数。

• 合并写入 (Batch Write):

  • Yii2 的 FileTarget 默认是一次性 file_put_contents 写入所有积攒的消息。
  • 确保你的 messages 数组积累得足够多再写。但受限于 PHP 请求声明周期，请求结束时必须强制刷盘。

5.3 减少日志量 (Log Sampling)

• 按需记录: 不要记录 DEBUG 或过于详细的 INFO。

• 采样记录: 对于高频接口（如心跳检测、健康检查），仅记录 1% 的流量。

  if (rand(1, 100) === 1) {
      Yii::info('Heartbeat', 'system');
  }
  

5.4 关闭 LogVars

• 'logVars' => []: 这是一个常见的性能杀手。默认情况下 Yii 会记录 $_SERVER 等所有全局变量。这些数据在序列化时不仅耗 CPU（特别是内容很大时），而且占用大量磁盘 I/O。生产环境必须置空。

5.5 减少日志文件写入的数量

如果一次请求不仅写 app.log，还要同时写 payment.log, trace.log等，性能损耗不是简单的线性叠加，而是倍增。

6. 架构层优化：ELK组合

真正的大型高并发项目都是有独立的日志服务器。

7. 总结

推荐配置 (PHP-FPM + Yii2)

1. 硬件: SSD + noatime 挂载。

2. Web Server: Nginx access_log 使用 buffer。

3. Yii2 配置:

   'log' => [
       'flushInterval' => 1000, 
       'targets' => [
           [
               'class' => 'yii\log\FileTarget',
               'exportInterval' => 1000, 
               'logVars' => [], // 关键：关闭上下文 dump
               'prefix' => function() { return ''; }, // 简化前缀
               // ...
           ]
       ]
   ]
   

4. 进阶: 如果上述仍无法满足，升级为 Redis 队列异步写。

本文由 best 创作，采用 知识共享署名 3.0 中国大陆许可协议 进行许可。 可自由转载、引用，但需署名作者且注明文章出处。