在高并发的Web应用或常驻内存的CLI脚本中，多个进程同时读写同一个文件是常见场景。如果缺乏有效的同步机制，就会出现数据覆盖、内容错乱甚至文件损坏的问题。PHP提供了多种处理文件锁定的机制，本文将详细解析在多进程环境中如何正确解决PHP文件系统锁定问题。
一、使用 flock() 实现文件咨询锁
PHP内置的 flock() 函数是实现文件锁最直接的方式。它提供了一种“咨询锁”（Advisory Lock），即只有当所有访问该文件的进程都使用 flock() 时，锁才会生效。flock 支持共享锁（读锁）和独占锁（写锁），这对于多进程读写分离场景非常实用。
共享锁（LOCK_SH）允许多个进程同时读取文件，而独占锁（LOCK_EX）在某一时刻只允许一个进程写入。
$filePath = '/var/www/www.ipipp.com/cache/data.txt';
$fp = fopen($filePath, 'c+');
if (flock($fp, LOCK_EX)) { // 获取独占锁
// 清空文件并写入新内容
ftruncate($fp, 0);
fwrite($fp, "多进程写入的安全内容n");
fflush($fp);
flock($fp, LOCK_UN); // 释放锁
} else {
echo "无法获取文件锁，请稍后重试";
}
fclose($fp); // 关闭文件句柄也会自动释放锁二、非阻塞模式处理并发冲突
默认情况下，flock() 是阻塞的。如果进程A持有锁，进程B调用 flock() 时会一直挂起等待，这在高并发Web场景下极易导致进程池耗尽。为了提高系统的响应能力，可以使用 LOCK_NB（非阻塞）标志位结合 LOCK_EX 或 LOCK_SH 使用。
在非阻塞模式下，如果获取锁失败，函数会立即返回 false，程序就可以执行降级逻辑或提示用户稍后重试。
$fp = fopen($filePath, 'r');
// 尝试获取非阻塞共享锁
if (flock($fp, LOCK_SH | LOCK_NB)) {
$content = stream_get_contents($fp);
flock($fp, LOCK_UN);
echo $content;
} else {
// 获取锁失败，不阻塞等待，直接走降级逻辑
echo "系统繁忙，读取失败，请稍后再试";
}
fclose($fp);三、利用原子操作 rename() 替代直接写入
在某些场景下（如生成缓存文件、更新配置文件），直接对原文件进行读写即使加了锁，在极端情况（如PHP进程在写入中途被kill掉）下仍可能产生半写状态的损坏文件。在POSIX系统中，rename() 函数是原子操作，它可以保证文件替换的完整性。
最佳实践是：先将内容写入一个临时文件，写入成功后再使用 rename() 将临时文件覆盖目标文件。读取文件的进程要么读到旧的完整内容，要么读到新的完整内容，不会读到中间状态。
$targetFile = '/var/www/www.ipipp.com/config/app.json'; $tempFile = $targetFile . '.tmp'; $data = ['status' => 1, 'api' => 'www.ipipp.com/api']; // 写入临时文件 file_put_contents($tempFile, json_encode($data)); // 原子操作：将临时文件重命名为目标文件 rename($tempFile, $targetFile);
四、注意事项与避坑指南
1. 及时释放锁： 获取锁后，无论业务逻辑是否抛出异常，都必须确保释放锁或关闭文件句柄。推荐在获取锁后立即使用 try...finally 结构来保障锁的释放。
2. NFS文件系统上的局限性： flock() 在本地文件系统上非常可靠，但在NFS等网络文件系统上，某些旧版本或特定配置的底层并不支持文件锁协议。如果部署环境依赖NFS，建议使用Redis或Memcached等基于内存的分布式锁来替代文件锁。
3. 避免死锁： 当多个进程需要同时锁定多个文件时，必须保证所有进程按照相同的文件顺序获取锁。如果进程A先锁文件1再锁文件2，而进程B先锁文件2再锁文件1，就会产生死锁。
4. 文件打开模式： 使用 flock() 时，务必确保以正确的模式打开文件。如果需要写入，不能以只读模式 r 打开，否则会导致写入失败；推荐使用 c+ 模式，它会在文件不存在时创建文件，且支持读写。