php 升级至 7.4.27 后，多进程并发场景下使用 `file()` 读取被 `file_put_contents(..., lock_ex)` 写入的日志文件时出现行中断截断，根本原因在于 `lock_ex` 仅对写操作生效且为**建议性锁**，而 `file()` 不参与锁协商，导致读取竞态。本文提供两种生产可用的修复方案。
在 Windows Server 环境下运行多个 PHP 控制台进程（如后台数据处理服务）时，日志写入与分析常面临典型的读写竞态（race condition）。您当前的写入逻辑：
@ file_put_contents($logsFileNamePath, $fileContents, FILE_APPEND | LOCK_EX);
虽启用了 LOCK_EX，但该锁仅在 file_put_contents 执行期间由写进程主动加锁并独占写入——它不阻止其他进程以任意方式打开或读取文件。而读取端调用的：
$logContent = file($filePath); // ⚠️ 无锁、无等待、无原子性保证
会直接调用系统级 read() 或 fread()，完全无视写进程持有的 flock 状态。因此当 file() 在写入中途读取（例如写入 500 字节后暂停，file() 恰好读取前 499 字节），就会产生行内截断（如 "ERROR: timeout at 2024-05-12 10:30:4" 而非完整行），这并非 PHP 7.4.27 的 Bug，而是长期以来被忽略的并发设计缺陷。
✅ 推荐方案一：读写双方统一使用 flock() 显式同步
修改读取逻辑，用 fopen() + flock() 主动申请共享锁（LOCK_SH），确保读取时写入已完全提交：
立即学习“PHP免费学习笔记（深入）”；
$fp = fopen($filePath, 'r');
if (!$fp) {
throw new RuntimeException("Failed to open log file: $filePath");
}
// 阻塞等待写入进程释放 LOCK_EX（自动兼容现有 file_put_contents 的锁）
if (!flock($fp, LOCK_SH)) {
fclose($fp);
throw new RuntimeException("Failed to acquire shared lock on $filePath");
}
$logLines = [];
while (($line = fgets($fp)) !== false) {
$logLines[] = rtrim($line, "\r\n"); // 安全去除换行符
}
flock($fp, LOCK_UN); // 立即释放锁，避免阻塞写入
fclose($fp);
// 反向分析（保持原有逻辑）
$logLines = array_reverse($logLines);
// ... 后续分析逻辑✅ 优势：零文件系统改动，兼容现有日志路径；LOCK_SH 与 LOCK_EX 天然互斥，写入完成前读取将阻塞。 ⚠️ 注意：Windows 下 flock() 对 NFS 共享卷支持有限，若日志存于网络路径，请验证锁有效性。
✅ 推荐方案二：原子化写入 —— 临时文件 + rename()
彻底规避读写竞争，利用 Windows 下 rename() 的原子性（同卷内重命名不可中断）：
写入端（修改后）：
$tempFile = $filePath . '.tmp'; file_put_contents($tempFile, $fileContents, FILE_APPEND | LOCK_EX); rename($tempFile, $filePath); // 原子替换，旧文件瞬间消失，新文件瞬间可见
读取端（修改后）：
if (!file_exists($filePath)) {
// 文件可能正被 rename，稍后重试或跳过
usleep(10000); // 10ms 等待
if (!file_exists($filePath)) {
throw new Exception("Log file not ready: $filePath");
}
}
$logContent = file($filePath);
if ($logContent === false) {
throw new RuntimeException("Failed to read log file: $filePath");
}
$logContent = array_reverse($logContent);✅ 优势：语义清晰、跨平台可靠、无需锁协调；rename() 在 NTFS 上是原子操作，不存在“半写”中间态。
⚠️ 注意：确保 $tempFile 与 $filePath 在同一磁盘卷（否则 rename() 会失败并退化为复制+删除，失去原子性）。
? 总结与最佳实践
- ❌ 不要依赖 LOCK_EX 单方面保护读写：file()、file_get_contents()、fopen(..., 'r') 均不检查锁状态，LOCK_EX 仅对同进程内后续 flock() 有效。
- ✅ 优先选用方案二（临时文件）：更符合“写入完成才可见”的业务语义，调试友好，且规避了 Windows 下 flock() 在某些 I/O 模式下的边缘行为。
- ? 若必须实时读取，务必让读写双方显式参与同一套锁机制（flock），并始终配对 LOCK_SH/LOCK_EX 与 flock($fp, LOCK_UN)。
- ? 测试建议：在高并发压力下（如循环快速写入+读取），用 hexdump -C 检查日志文件末尾是否出现不完整 UTF-8 字符或断裂行，验证修复效果。
通过以上任一方案，即可彻底解决 PHP 7.4.27+ 中因并发读写导致的日志截断问题，且代码简洁、可维护性强，适用于生产环境长期运行。
