如何在PHP中实现文件锁？通过flock防止并发冲突

星夢妙者

发布时间：2025-09-05 22:56:02

190人浏览过

来源于php中文网

原创

flock()函数用于实现文件锁，通过共享锁（LOCK_SH）和独占锁（LOCK_EX）协调多进程对文件的并发访问，防止竞态条件导致的数据损坏或不一致；其基于建议性锁定机制，需所有访问方共同遵守锁规则，且在NFS等网络文件系统中可能存在兼容性问题，同时应防范阻塞、死锁及异常未释放锁等风险，确保在操作完成后显式释放锁并妥善处理错误。

如何在php中实现文件锁？通过flock防止并发冲突

在PHP中实现文件锁，主要依赖于内置的

flock()

函数。它提供了一种相当直接且有效的方式来管理对共享文件的并发访问，从而避免在多个进程或请求同时尝试修改同一文件时可能发生的数据损坏或不一致问题。这就像给文件设置一个“请勿打扰”或“我正在使用”的标志，确保同一时间只有一个或一类操作能顺利进行。

解决方案

flock()

函数的使用并不复杂，它需要一个已经打开的文件句柄，以及你希望执行的锁定操作类型。基本流程通常是：打开文件 -youjiankuohaophpcn 尝试获取锁 -> 执行文件操作 -> 释放锁 -> 关闭文件。

这里有一个使用排他锁（独占锁）的例子，这在需要写入文件时非常常见：

<?php
$filePath = 'data/counter.txt'; // 假设这个文件用于记录访问次数

// 确保文件存在，如果不存在则创建
if (!file_exists(dirname($filePath))) {
    mkdir(dirname($filePath), 0777, true);
}
if (!file_exists($filePath)) {
    file_put_contents($filePath, '0');
}

$fp = fopen($filePath, 'r+'); // 以读写模式打开文件

if ($fp === false) {
    // 实际应用中应该有更健壮的错误处理
    error_log("无法打开文件: " . $filePath);
    exit("系统繁忙，请稍后再试。");
}

// 尝试获取独占锁（排他锁），如果文件已经被其他进程锁定，则会阻塞等待
if (flock($fp, LOCK_EX)) { // LOCK_EX 是独占锁
    // 成功获取锁，现在可以安全地读写文件了
    $counter = (int)fread($fp, filesize($filePath));
    $counter++;

    // 将文件指针重置到文件开头，以便写入
    ftruncate($fp, 0); // 清空文件内容
    rewind($fp);       // 将文件指针移到文件开头

    fwrite($fp, $counter);

    // 释放锁
    flock($fp, LOCK_UN); // LOCK_UN 是释放锁
} else {
    // 获取锁失败，可能是其他进程长时间占用，或者文件系统不支持
    error_log("无法获取文件锁: " . $filePath);
    echo "系统繁忙，请稍后再试。";
}

fclose($fp); // 关闭文件句柄

echo "当前访问次数: " . $counter;
?>

如果你只是想读取文件，并且允许其他进程同时读取，但不能写入，你可以使用共享锁：

立即学习“PHP免费学习笔记（深入）”；

<?php
$filePath = 'data/some_shared_config.json';
$fp = fopen($filePath, 'r'); // 以只读模式打开文件

if ($fp === false) {
    error_log("无法打开文件: " . $filePath);
    exit("配置读取失败。");
}

// 尝试获取共享锁，允许多个进程同时持有共享锁
if (flock($fp, LOCK_SH)) { // LOCK_SH 是共享锁
    $configData = fread($fp, filesize($filePath));
    $config = json_decode($configData, true);

    flock($fp, LOCK_UN); // 释放锁
} else {
    error_log("无法获取文件共享锁: " . $filePath);
    echo "配置读取失败，请稍后再试。";
}

fclose($fp);
// var_dump($config); // 可以处理 $config 数据
?>

为什么并发访问文件会引发问题？

在我看来，并发访问文件导致的问题，其核心在于一个词：竞态条件（Race Condition）。简单来说，就是多个独立的执行流（比如不同的PHP-FPM进程，或者CLI脚本）在没有协调机制的情况下，试图同时对同一个文件进行读写操作。这就像好几个人同时冲向一块白板，每个人都想写点东西，结果就是字迹重叠、内容混乱，甚至有人写到一半就被擦掉了。

具体来说，可能出现以下几种情况：

数据损坏或丢失： 比如上面计数器的例子。两个进程同时读取到计数是“10”，然后都计算出“11”，并尝试写入。如果第一个进程写入“11”后，第二个进程紧接着也写入“11”，那么计数器实际上只增加了1次，而不是预期的2次。更糟糕的是，如果写入操作不是原子的（通常都不是），一个进程可能只写了一半，另一个进程就开始写，最终文件里就剩下了一堆乱码。
数据不一致： 一个进程可能正在修改文件，而另一个进程却在读取这个“半成品”文件。读取到的数据可能是不完整、不准确，甚至是完全错误的状态。这在缓存文件、配置文件等场景下尤其危险，可能导致应用程序行为异常。
死锁（虽然在文件锁中相对少见，但仍需注意）： 两个或多个进程相互等待对方释放资源，导致所有进程都无法继续执行。虽然
```
flock()
```
本身通常不会直接导致死锁（因为它通常是阻塞等待），但在更复杂的应用场景中，如果涉及多个资源的锁定顺序不当，依然可能发生。

这些问题在低并发环境下可能不明显，但一旦流量上来，它们就会像定时炸弹一样，随时可能引爆，造成难以排查的生产事故。因此，理解并解决并发冲突，是构建健壮应用的关键一环。

flock()

的工作原理与锁类型详解

flock()

函数实际上是PHP对底层操作系统文件锁定机制的封装。它的工作原理属于建议性锁定（Advisory Locking）。这意味着，操作系统本身并不会强制阻止其他进程访问被

flock()

锁定的文件。只有那些也尝试使用

flock()

来获取锁的进程，才会遵守这个约定。如果一个进程直接使用

file_put_contents()

或者

fwrite()

而不调用

flock()

，它就能绕过锁，直接操作文件。这一点非常重要，也是

flock()

的一个常见误区。

flock()

支持四种操作类型，通过第二个参数来指定：

```
LOCK_SH
```
(共享锁 / Shared Lock)：
- 作用： 允许多个进程同时持有对同一文件的共享锁。
- 场景： 主要用于文件读取。当多个进程需要读取同一个文件时，它们可以同时获取共享锁，互不影响。
- 冲突： 如果有任何进程持有共享锁，那么其他进程就无法获取到独占锁。
- 我的理解： 这就像图书馆的借阅区，大家都可以同时看书，但如果有人想把整间图书馆都搬走（独占），那就不行了。
```
LOCK_EX
```
(独占锁 / Exclusive Lock)：

GentleAI
GentleAI是一个高效的AI工作平台，为普通人提供智能计算、简单易用的界面和专业技术支持。让人工智能服务每一个人。

下载
- 作用： 任何时候，只有一个进程可以持有对文件的独占锁。
- 场景： 主要用于文件写入。当一个进程需要修改文件时，它会获取独占锁，确保在它修改期间，没有其他进程可以读取或写入该文件。
- 冲突： 如果一个进程持有独占锁，那么其他任何进程都无法获取共享锁或独占锁，它们会被阻塞，直到锁被释放。
- 我的理解： 这就像一个会议室，只有一个人能预订并使用，其他人都得在外面等着。
```
LOCK_UN
```
(释放锁 / Unlock)：
- 作用： 显式地释放文件上的任何锁。
- 场景： 在完成文件操作后，应该立即调用此函数来释放锁，以便其他等待的进程能够获取到锁。
- 注意： 当文件句柄被
```
fclose()
```
  关闭时，所有在该句柄上持有的锁都会自动释放。但显式释放是一个好习惯，尤其是在复杂逻辑中。
```
LOCK_NB
```
(非阻塞锁 / Non-blocking Lock)：
- 作用： 可以与
```
LOCK_SH
```
  或
```
LOCK_EX
```
  结合使用。如果尝试获取锁时文件已经被锁定，
```
flock()
```
  会立即返回
```
false
```
  ，而不是阻塞等待。
- 场景： 当你不希望进程因为等待锁而长时间阻塞时使用。比如，你宁愿放弃当前操作，稍后重试，也不想让用户界面卡死。
- 用法：
```
flock($fp, LOCK_EX | LOCK_NB)
```
  。

flock()

的返回值也很关键：成功获取锁返回

true

，失败返回

false

。因此，在使用

flock()

时，务必检查其返回值，并根据结果采取相应的错误处理或重试策略。

flock()

在实际应用中的注意事项与陷阱

尽管

flock()

看起来简单直观，但在实际应用中，它有一些特性和潜在的陷阱，需要我们特别注意。

建议性锁定而非强制性： 这是最关键的一点。正如前面提到的，
```
flock()
```
是“君子协定”。如果你的应用程序中，一部分代码使用了
```
flock()
```
，而另一部分（或者其他不相关的程序）直接通过
```
file_put_contents()
```
或
```
fwrite()
```
操作同一个文件，那么这些不使用
```
flock()
```
的代码会完全无视你设置的锁。这可能导致数据损坏，因为锁并没有真正起到保护作用。所以，确保所有访问目标文件的代码路径都遵循相同的
```
flock()
```
约定，至关重要。
网络文件系统（NFS）上的行为不一致： 在某些网络文件系统（如NFS）上，
```
flock()
```
的行为可能会变得不可靠，甚至根本不起作用。这是因为NFS协议对文件锁定的支持程度和实现方式各不相同。如果你在分布式系统或共享存储环境中使用
```
flock()
```
，务必进行充分测试。对于这类环境，通常更推荐使用分布式锁服务（如Redis的Redlock、ZooKeeper或数据库的行级锁），它们提供了更健壮和可靠的跨机器锁定机制。
死锁的可能性： 尽管
```
flock()
```
本身在单个文件上通常不会直接导致死锁（因为它只是阻塞等待），但在涉及多个文件或更复杂资源锁定的场景中，死锁依然是需要考虑的问题。例如，进程A锁定了文件1并尝试锁定文件2，同时进程B锁定了文件2并尝试锁定文件1。这时，两个进程都将无限期地等待对方释放资源。解决这类问题通常需要遵循严格的锁定顺序，或者使用非阻塞锁(
```
LOCK_NB
```
)配合重试机制来避免无限期等待。
性能开销与阻塞： 每次获取和释放锁都会有一定的性能开销。更重要的是，如果锁被长时间持有，其他等待的进程就会被阻塞，导致整个应用的响应速度下降。在使用
```
LOCK_EX
```
时尤其要注意，尽量缩短持有锁的时间，只在必要的关键操作期间持有。对于高并发场景，如果文件操作是瓶颈，可能需要重新评估是否应该使用文件锁，或者考虑更高效的替代方案，比如消息队列、数据库事务等。
忘记释放锁的后果： 如果一个进程在获取锁后异常终止（例如，PHP脚本执行超时、内存溢出或被强制终止），而没有来得及释放锁，那么这个锁可能会一直被操作系统持有，导致其他进程无法获取锁。虽然大多数现代操作系统在进程终止时会自动清理其持有的文件锁，但这种行为并非100%可靠，尤其是在某些边缘情况下。因此，编写健壮的代码，确保在任何情况下都能释放锁（例如，使用
```
try...finally
```
结构，在PHP中通常是在
```
finally
```
块中关闭文件句柄，
```
fclose
```
会自动释放锁），是非常重要的。
错误处理的重要性：
```
flock()
```
返回
```
true
```
或
```
false
```
。我们必须检查这个返回值。如果
```
flock()
```
返回
```
false
```
，意味着未能成功获取锁，这时不应该继续执行文件操作。我们需要有相应的错误处理逻辑，比如记录日志、向用户显示友好的错误信息、或者进行重试。忽略
```
flock()
```
的返回值是导致并发问题的常见原因。