如何使用 PHP 的 flock() 实现真正的单次文件访问控制-php教程-PHP中文网

如何使用 PHP 的 flock() 实现真正的单次文件访问控制

本文详解为何 flock($file, LOCK_EX) 默认会阻塞而非返回 false，以及如何通过非阻塞锁（LOCK_EX | LOCK_NB）正确实现“忙时提示”，确保多请求下仅一个进程执行、其余立即显示“Busy”。

本文详解为何 `flock($file, lock_ex)` 默认会阻塞而非返回 false，以及如何通过非阻塞锁（`lock_ex | lock_nb`）正确实现“忙时提示”，确保多请求下仅一个进程执行、其余立即显示“busy”。

在 PHP 中，使用 flock() 对文件加排他锁（LOCK_EX）是实现简单进程互斥的常用方式。但一个常见误区是：默认的 flock($file, LOCK_EX) 是阻塞式调用——当文件已被其他进程锁定时，当前脚本会一直挂起等待，直到锁释放，而不会进入 else 分支。这正是原代码始终不输出“Busy”、所有新请求都陷入 sleep(60) 的根本原因。

要实现“尝试获取锁，失败则立即响应”，必须启用非阻塞模式：在锁标志中添加 LOCK_NB（Non-Blocking）。此时若锁不可用，flock() 将立即返回 false，从而允许我们执行自定义逻辑（如提示“Busy”）。

✅ 正确写法如下：

<?php $file = fopen('file.txt', 'c+'); // 使用 'c+' 更安全：打开文件（不存在则创建），不截断
if ($file === false) {
    die('无法打开文件');
}

// 尝试以非阻塞方式获取独占锁
if (flock($file, LOCK_EX | LOCK_NB)) {
    // 成功获得锁：执行关键操作
    echo "Processing...\n";
    sleep(60); // 模拟耗时任务
    flock($file, LOCK_UN); // 释放锁
} else {
    // 锁被占用或获取失败 → 立即响应
    echo "Busy";
}

fclose($file);

? 关键要点说明：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

LOCK_EX | LOCK_NB 是核心：LOCK_NB 确保 flock() 不阻塞，失败时返回 false；
文件打开模式建议用 'c+'：避免因文件不存在导致 fopen() 失败；'w+' 会清空文件内容，且在某些系统上可能影响锁行为；
务必检查 fopen() 返回值：防止因权限/路径问题导致后续 flock() 调用未定义行为；
锁与文件句柄绑定：锁在 fclose() 或脚本结束时自动释放，但显式调用 flock($file, LOCK_UN) 更清晰、更安全；
注意 Web 服务器并发模型：PHP-FPM 或 Apache 的多进程/多线程环境均支持 flock()，但需确保所有进程访问的是同一物理文件（NFS 等共享存储需额外验证锁兼容性）。