多个php 8.6进程写同一份本地jsonl日志时,可以在追加前取得flock排他锁,在锁内完成整行写入和fflush,再释放锁。所有写入者必须遵守同一约定;这个方法避免的是协作进程之间的内容交错,不保证网络文件系统、日志轮转或机器断电下的完整持久性。

flock官方手册说明排他锁、非阻塞模式及协作限制
锁等待有截止时间,写入处理短写
<?php
$line = json_encode(['event' => 'job_finished', 'id' => 7],
JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR) . "\n";
if (strlen($line) > 16384) throw new LengthException('单行日志过大');
$fp = fopen(__DIR__ . '/events.jsonl', 'ab');
if ($fp === false) throw new RuntimeException('无法打开日志');
$locked = false;
try {
$deadline = hrtime(true) + 2_000_000_000;
do {
$blocked = 0;
$locked = flock($fp, LOCK_EX | LOCK_NB, $blocked);
if ($locked) break;
if (!$blocked) throw new RuntimeException('文件锁失败');
if (hrtime(true) >= $deadline) throw new RuntimeException('等待日志锁超时');
usleep(10000);
} while (true);
$offset = 0;
while ($offset < strlen($line)) {
$written = fwrite($fp, substr($line, $offset));
if ($written === false || $written === 0) throw new RuntimeException('日志写入失败');
$offset += $written;
}
if (!fflush($fp)) throw new RuntimeException('刷新日志失败');
} finally {
if ($locked) flock($fp, LOCK_UN);
fclose($fp);
}JSON编码会把字段内换行写成转义序列,最后手工追加的换行才是JSONL记录分隔符。示例不使用用户提交的日志路径,也不记录密码或访问令牌。16KiB单行及2秒锁等待是示例策略,生产值应按日志用途和故障处理要求设置。
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。

官方示例在刷新文件缓冲区后释放锁,并展示LOCK_NB用法
锁不能修复已经发生的I/O失败
磁盘写满或进程异常退出时,最后一行仍可能只写了一部分。读取端应识别尾部不完整记录,运维应监控写入失败;不能把flock描述成数据库事务或断电保护。日志轮转涉及文件重命名和旧句柄,需由统一的轮转策略管理,不能让每个写入进程自行替换文件。


















