PHP高并发日志性能瓶颈源于同步写磁盘，有效方案是异步落盘：Swoole用swoole_async_writefile()解耦主线程，FPM环境则用Monolog+BufferHandler批量写入并禁用文件锁，同时优化文件系统（noatime、SSD/NVMe）。
PHP 在高并发场景下直接写文件日志极易成为性能瓶颈，fwrite 阻塞、磁盘 I/O 竞争、锁争用都会拖慢整个请求响应。真正有效的方案不是“优化单次写入”，而是绕开同步写磁盘这个动作本身。
为什么 error_log() 和 file_put_contents() 在高并发下会拖垮服务
这两个函数默认都是同步、阻塞式写入。当 100 个请求同时调用 file_put_contents('app.log', $msg, FILE_APPEND)，它们会排队等同一个文件锁（即使启用了 LOCK_EX），实际变成串行写入；更糟的是，若磁盘负载高或日志路径在机械硬盘上，单次写入可能耗时几十毫秒——100 个请求就卡住几秒。
-
error_log()默认不缓冲，且无法控制日志格式和分文件，不适合业务日志 -
file_put_contents()每次都 open → write → close，系统调用开销大 - 即使加了
FILE_APPEND | LOCK_EX，锁粒度是整个文件，不是行级 - PHP-FPM worker 进程被阻塞后，无法处理新请求，连接堆积，触发超时或 504
用 swoole_async_writefile() 或消息队列异步落盘
把日志写入从“请求线程中执行”移到“后台异步执行”，是解耦的关键。Swoole 提供的 swoole_async_writefile() 是最轻量的落地方式：它由 Swoole 的异步线程池完成写入，PHP 主线程完全不阻塞。
- 仅适用于 CLI 或 Swoole Server 环境，不适用于传统 FPM + Apache/Nginx 组合
- 写入失败不会抛异常，需检查回调函数里的
$result参数是否为false - 注意日志内容不能含 \0 字符，否则截断（
swoole_async_writefile按 C 字符串处理） - 示例：
swoole_async_writefile('app.log', date('Y-m-d H:i:s') . " [INFO] User login\n", function($filename, $result) { if ($result === false) { // 写入失败，可降级到 error_log() 或丢弃 error_log("Async log failed: $filename"); } });
用 monolog + StreamHandler 配合缓冲与轮转
如果必须用 FPM，monolog 是最稳妥的选择，但默认配置依然危险。关键调整点不在“用不用”，而在“怎么配”：
立即学习“PHP免费学习笔记（深入）”；
- 禁用
StreamHandler的$useLocking = true（默认 false，但很多教程误开）——锁文件是性能杀手 - 启用
BufferHandler包裹StreamHandler，批量写入（例如每 50 条 flush 一次）$handler = new BufferHandler( new StreamHandler('app.log', Logger::INFO), 50, Logger::INFO, true, false // 不加锁 ); - 务必设置
RotatingFileHandler替代纯文件追加，避免单文件无限增长导致tail -f卡死、ls变慢 - 日志格式精简：关闭 trace、context 中的大数组 dump，用
json_encode($context, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)控制体积
别忽略 PHP 自身的 opcache.preload 和日志路径的文件系统选择
很多人调优只盯日志库，却忘了底层支撑。两个常被跳过的硬性影响点：
- 日志目录所在分区如果是 ext3 或没开启
noatime，每次写入都会更新 inode 访问时间，额外增加一次磁盘写 —— 改用 ext4/xfs 并挂载时加noatime - PHP 8.0+ 开启
opcache.preload后，monolog类加载不再有 opcode 解析开销，高频日志场景下能省出 0.1~0.3ms/次 - 日志路径尽量避免 NFS 或网络存储；本地 SSD 是底线，NVMe 更佳；
/dev/shm可临时缓存但不可持久化，适合做二级缓冲
真正的瓶颈往往不在“怎么记日志”，而在于“谁来记、何时记、记到哪”。异步写入、批量合并、文件系统配合，三者缺一不可。最容易被忽略的是：日志路径的挂载选项和磁盘类型，它们不会报错，但会在 QPS 上千时默默吃掉 30% 的吞吐能力。
