PHP文件写入防冲突：flock独占锁定实战详解

核心工具：flock 函数参数解析

flock() 是PHP用于对文件指针进行加锁的内置函数。其操作的对象必须是已经成功打开的文件指针。在进行写入前，理解可用的操作常量至关重要：

• LOCK_SH：共享锁定（读取）。其他程序仍可读取或获取共享锁，但不允许获取独占锁。
• LOCK_EX：独占锁定（写入）。这是防止并发写入的关键，获取该锁后，其他任何程序无法获取该文件的读/写锁。
• LOCK_UN：释放锁定。务必在操作完成后调用，否则会导致死锁或长时间占用资源。
• LOCK_NB：非阻塞模式。若此时无法获取锁，不等待直接返回，避免进程挂起。

第1步：准备写入环境与超时策略

由于网络延迟或竞争条件，flock 可能无法立即获取锁。因此，实践中通常需要一个带超时的轮询机制来代替单纯的阻塞等待，以防止进程永久挂起。

第2步：构建安全写入函数

以下示例封装了一个安全的文件追加写入函数。它包含三个关键阶段：尝试获取锁、执行写入、释放锁。

function file_write($file_name, $text, $mode='a', $timeout=30) {
    // 1. 打开文件
    $handle = fopen($file_name, $mode);
    if (!$handle) {
        return false;
    }

    // 2. 获取锁的逻辑（带超时）
    while ($timeout > 0) {
        if (flock($handle, LOCK_EX)) { // 尝试获取排他性锁
            break; // 成功后跳出循环
        }
        $timeout--;
        sleep(1); // 每秒重试一次
    }

    // 3. 判断是否成功获取锁
    if ($timeout > 0) {
        // 4. 执行写入并释放资源
        fwrite($handle, $text . '\n');
        flock($handle, LOCK_UN); // 释放锁定
        fclose($handle);         // 关闭文件句柄
        return true;
    }

    // 5. 超时处理
    fclose($handle);
    return false;
}

风险提醒与最佳实践

在使用文件锁定时，需特别注意以下两点以避免系统故障：
1. 必须释放锁： 如果脚本在获取锁后发生致命错误而崩溃，可能导致锁未被释放。虽然 PHP 通常在脚本结束或连接关闭时自动解锁，但手动调用 flock($handle, LOCK_UN) 是更稳妥的做法。
2. 仅适用于本地服务器： flock 主要基于本地文件系统（如ext3/ext4/xfs）。如果使用 NFS 等网络文件系统且配置不当，文件锁可能无法在不同服务器节点间生效，此时需要考虑数据库行锁或分布式锁（如Redis）方案。

完成判断

通过观察日志文件或目标文本内容，确认并发访问时不会出现数据交错或覆盖，即说明锁定机制生效。

以上就是PHP利用flock实现文件安全写入的详细解析，更多关于PHP文件操作的技巧请关注本站其它相关文章！