异常教程

PHP flock() 函数（超详细）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

什么是文件锁？为什么需要它？

在 PHP 开发中，当多个进程或线程同时访问同一文件时，可能会引发数据竞争（Data Race）问题。例如，两个脚本同时尝试修改同一个计数器文件，可能导致最终结果丢失或不一致。文件锁（File Locking）就是为了解决这类问题而设计的机制。

PHP 的 flock() 函数正是实现文件锁的核心工具。它通过控制文件的读写权限，确保同一时间只有一个进程能执行特定操作。这类似于现实中的“钥匙-锁”机制：只有持有钥匙（锁）的进程才能修改文件，其他进程需等待释放后才能继续。

flock() 函数基础：语法与参数解析

函数语法

bool flock ( resource $handle , int $operation [, bool &$would_block = NULL ] )

参数说明

参数说明
handle必需。要加锁的文件指针（由 fopen() 等函数返回）。
operation必需。锁的类型，如 LOCK_EX（独占锁）、LOCK_SH（共享锁）等。
would_block可选。当锁被阻塞时返回 true，否则返回 false。

锁类型详解

  1. 独占锁（LOCK_EX）

    • 禁止其他进程同时获取独占或共享锁。
    • 类比：一位作者正在修改文档，其他人只能等待。

  2. 共享锁（LOCK_SH）

    • 允许多个进程同时获取共享锁，但独占锁会阻塞它们。
    • 类比：多人同时阅读同一本书，但无法同时编辑。

  3. 解锁（LOCK_UN）

    • 释放之前申请的锁。

实战案例：如何正确使用 flock()

案例1：计数器同步

假设需要统计网站访问量，但多个请求可能同时修改计数文件：

$filename = 'counter.txt';  
$fp = fopen($filename, 'c+'); // 以读写模式打开文件  

// 尝试获取独占锁  
if (flock($fp, LOCK_EX)) {  
    // 加锁成功后读取并更新计数  
    $count = intval(trim(fgets($fp))) + 1;  
    ftruncate($fp, 0); // 清空文件内容  
    fseek($fp, 0);     // 移动指针到开头  
    fwrite($fp, $count);  
    flock($fp, LOCK_UN); // 释放锁  
} else {  
    echo "无法获取锁！";  
}  
fclose($fp);

关键点解析

  • 'c+' 模式：允许读写，若文件不存在则创建。
  • ftruncate()：清空文件内容，避免重复写入。
  • 锁的及时释放：在 try-finally 块或 finally 中确保解锁，避免死锁。

案例2：日志文件写入

在日志记录场景中，多个进程可能同时写入日志文件：

$logfile = 'app.log';  
$fp = fopen($logfile, 'a'); // 追加模式  

if (flock($fp, LOCK_EX)) {  
    fwrite($fp, date('Y-m-d H:i:s') . ' - ' . "日志信息\n");  
    flock($fp, LOCK_UN);  
} else {  
    echo "日志写入失败！";  
}  
fclose($fp);

优化建议

  • 使用 LOCK_EX 确保每次写入互斥。
  • 日志文件建议使用独立线程或队列处理，减少锁竞争。

进阶技巧：flock() 的高级用法

1. 非阻塞锁

通过 LOCK_NB 参数实现非阻塞加锁，避免脚本长时间等待：

if (!flock($fp, LOCK_EX | LOCK_NB)) {  
    echo "锁被占用，暂时无法操作！";  
} else {  
    // 执行操作并释放锁  
}

2. 锁的粒度控制

锁的作用范围由文件指针决定。例如：

// 锁整个文件  
$fp = fopen('data.txt', 'r+');  
flock($fp, LOCK_EX);  

// 锁文件的某一段（需结合文件偏移量）  
fseek($fp, 100); // 移动到第100字节  
flock($fp, LOCK_EX); // 仅锁定当前位置之后的内容

3. 与数据库锁的对比

  • 文件锁：轻量级，适合简单场景，但跨服务器无效。
  • 数据库锁：事务级控制，适合复杂数据操作，但性能开销更大。

常见问题与注意事项

1. 死锁风险

若进程 A 锁定文件后未及时释放，其他进程将永远等待。解决方案：

  • 在 try-catch 块中确保解锁。
  • 设置超时机制，例如通过 stream_set_timeout()。

2. 跨进程兼容性

flock() 仅在同一文件系统内有效，分布式系统需使用其他方案（如 Redis 锁）。

3. 性能影响

频繁加锁可能拖慢系统。优化建议：

  • 减少锁的持有时间。
  • 合理设计业务逻辑，降低锁竞争概率。

结论：合理运用文件锁，提升系统可靠性

通过 flock() 函数，开发者可以轻松实现文件级同步，避免多进程环境下的数据混乱。无论是计数器、日志记录还是文件写入场景，合理设计锁的粒度和超时机制，都能显著提升程序的健壮性。

作为开发者，理解锁的底层原理并结合实际业务场景灵活应用，是构建高并发系统的重要基础。希望本文能帮助你掌握 flock() 函数的核心用法，并在项目中游刃有余地解决文件同步问题。

关键词布局：PHP flock() 函数、文件锁、独占锁、共享锁、非阻塞锁、死锁、文件同步、计数器、日志记录、多进程、锁粒度

最新发布

查看更多文章