PHP 文件锁实现单实例执行与并发控制

为什么需要文件锁？

在多进程或多线程环境下，如果两个进程同时尝试写入同一个文件，可能会导致内容交错、数据丢失或逻辑错误。通过文件锁（File Locking），我们可以让操作系统级别的互斥机制来协调访问。如果一个进程获得了锁，其他请求锁的进程将被阻塞或直接返回失败，直到锁被释放。

PHP 文件锁的核心原理

PHP 内置了 flock() 函数用于文件锁定。常见的锁类型包括：

• LOCK_SH：读取锁（共享锁），允许其他人也读取，但不允许写入。
• LOCK_EX：写入锁（独占锁），排斥其他所有读写操作，适合写入场景。
• LOCK_NB：非阻塞模式。如果无法立即获得锁，不等待直接返回失败；若不设置此参数，则默认阻塞等待直到获得锁。
• LOCK_UN：释放锁。

实现安全的加锁与解锁函数

为了简化使用并确保资源正确释放，下面提供了一个封装好的类或函数集合。它们利用一个辅助的锁定文件来控制主业务逻辑的并发。

第1步：定义加锁函数 lock_thisfile

该函数的目的是获取独占锁。如果加锁失败（例如其他进程已持有锁），根据参数决定是直接返回 false 还是继续等待。

<?php
/**
 * 获得独享锁
 * @param string $tmpFileStr 用来作为共享锁文件的文件名（可以随便起一个名字）
 * @param bool $wait 是否等待锁，true 表示阻塞直到获得锁，false 表示立即返回
 * @return resource|false 锁资源句柄，失败返回 false
 */
function lock_thisfile($tmpFileStr, $wait = true) {
    // 确定锁的类型
    // LOCK_EX: 独占锁
    // LOCK_NB: 非阻塞 (仅当 $wait 为 false 时使用)
    $lockType = ($wait === false) ? (LOCK_EX | LOCK_NB) : LOCK_EX;
    
    $canWrite = 0;
    // 创建或打开用于锁控制的临时文件
    $lockFp = @fopen($tmpFileStr . ".lock", "w");
    
    if ($lockFp) {
        // 尝试获取锁
        $canWrite = @flock($lockFp, $lockType);
    }
    
    if ($canWrite) {
        return $lockFp; // 成功，返回文件指针供后续解锁使用
    } else {
        // 失败时的清理工作
        if ($lockFp) {
            @fclose($lockFp);
            @unlink($tmpFileStr . ".lock");
        }
        return false;
    }
}

第2步：定义解锁函数 unlock_thisfile

在业务逻辑完成后，必须调用此函数释放锁并清理辅助文件，否则可能导致死锁或残留文件。

/**
 * 对先前取得的锁实例进行解锁
 * @param resource $fp lock_thisfile 返回的文件指针
 * @param string $tmpFileStr 与加锁时相同的临时文件名
 */
function unlock_thisfile($fp, $tmpFileStr) {
    if ($fp) {
        // 1. 释放锁
        @flock($fp, LOCK_UN);
        // 2. 关闭文件指针（注意：原始草稿中有重复 fclose，此处修正为单次关闭）
        @fclose($fp);
    }
    // 3. 删除用于锁控制的辅助文件
    @unlink($tmpFileStr . ".lock");
}

使用示例：确保单实例运行

以下代码展示了如何在实际脚本中使用上述函数。假设你有一个耗时较长的任务，希望确保在任何时刻只有一个实例在运行。

<?php
// 指定锁文件的基础名称，建议放置在 /tmp 或具有写权限的目录
$tmpFileStr = "/tmp/my_script_lock.loc";

// 尝试获取锁，第二个参数设为 true 表示阻塞等待直到获得锁
// 如果想快速失败，可设为 false
$lockHandle = lock_thisfile($tmpFileStr, true);

if ($lockHandle) {
    try {
        // === 开始执行独占业务逻辑 ===
        // 在这里进行所有需要独占的事务处理，例如写入数据库、处理大文件等
        echo "已获得锁，开始执行任务...\n";
        sleep(5); // 模拟耗时操作
        echo "任务执行完毕。\n";
        // === 结束独占业务逻辑 ===
    } finally {
        // 无论成功还是异常，都务必释放锁
        unlock_thisfile($lockHandle, $tmpFileStr);
        echo "锁已释放。\n";
    }
} else {
    echo "无法获得锁，可能已有其他实例正在运行。\n";
}
?>

注意事项与排错

• 权限问题：确保 PHP 进程有权限在指定目录（如 /tmp）创建和删除 .lock 文件。
• 强制杀进程的风险：如果持有锁的进程被强制杀死（如 kill -9），unlock_thisfile 将不会自动执行。在这种情况下，操作系统通常会在脚本结束时自动解除文件句柄上的锁，但 .lock 辅助文件可能会残留。建议在生产环境中加入定期清理残留锁文件的 cron 任务。
• 文件系统支持：flock() 在所有主流文件系统上都有效，但在某些网络文件系统（NFS）上可能需要特定的挂载选项才能正常工作。

总结

通过封装 flock()，我们可以轻松地在 PHP 应用中实现基于文件的互斥锁，从而解决并发写入导致的同步错误问题。掌握 LOCK_EX 和 LOCK_NB 的使用场景，结合正确的资源释放逻辑，是保证后端服务稳定性的关键。 以上就是 PHP 文件加锁解锁及并发控制功能的详细内容，更多关于 PHP 高级应用与性能优化的资料请关注本站其它相关文章！