flock() 无法直接检测文件是否被锁，需用非阻塞独占锁尝试：若 LOCK_EX | LOCK_NB 失败且 errno 为 EWOULDBLOCK/EACCES，则文件大概率已被其他进程锁定；is_writable() 仅检查权限，不能替代锁检测。
用 flock() 检测文件是否被其他进程加锁
PHP 本身没有直接返回“文件当前是否被锁”的函数，flock() 的行为是尝试加锁并返回布尔结果，因此需借助“非阻塞尝试加锁 + 立即释放”来间接判断。关键不是看锁是否存在，而是看能否抢到锁。
典型做法是用 LOCK_NB | LOCK_EX 尝试独占加锁，若失败且 errno 是 EWOULDBLOCK（Linux/macOS）或 EACCES（Windows），说明文件正被其他进程持有写锁。
- 必须先
fopen()以可写模式（如'c'或'r+'）打开文件句柄，只读打开无法加写锁 - 加锁后务必调用
flock($fp, LOCK_UN)解锁，否则可能干扰后续逻辑 - Windows 下
flock()仅对同一文件的 PHP 进程有效，跨语言（如 C 程序用LockFile）不保证互斥
为什么 is_writable() 不能代替锁检测
is_writable() 只检查文件权限和父目录写权限，完全不反映运行时锁定状态。一个文件权限全开，但正被另一个 PHP 进程用 flock() 锁住，is_writable() 仍返回 true，此时直接写入可能引发数据错乱。
- 常见误用：在写入前只做
if (is_writable($path)) { file_put_contents(...); }—— 这毫无并发保护 - 真实场景中，两个请求几乎同时执行该逻辑，都通过
is_writable()，然后都写入，后者覆盖前者 - 真正需要的是“此刻能否安全写”，这只能靠
flock()的原子性尝试来推断
跨平台检测的兼容写法示例
以下函数返回 true 表示文件当前**不可被立即加写锁**（即大概率已被锁），false 表示可安全加锁：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“PHP免费学习笔记（深入）”；
function is_file_locked(string $path): bool
{
$fp = @fopen($path, 'c');
if (!$fp) {
return true; // 文件不存在或无法打开，视为“不可用”
}
$locked = !flock($fp, LOCK_EX | LOCK_NB);
flock($fp, LOCK_UN);
fclose($fp);
return $locked;
}
注意：@fopen 抑制警告，因为 fopen('missing.txt', 'c') 会创建文件，而你只想检测已有文件；若需严格限定只检测存在文件，改用 'r+' 并先 file_exists()。
容易忽略的底层细节
文件锁是进程级、内核级的，但 PHP 的 flock() 是 advisory（建议性）锁——它只在所有参与者都主动调用 flock() 时才生效。如果某个脚本直接用 file_put_contents() 写入而不加锁，其他进程的 flock() 完全感知不到。
- 不要依赖锁来阻止“恶意”或遗留脚本的写入，只能协调你自己控制的 PHP 进程
-
flock()锁绑定到文件描述符，不是文件路径；同一文件被多次fopen()，每个句柄需单独加锁 - 进程崩溃或未显式
flock($fp, LOCK_UN)时，锁会在句柄关闭（包括脚本结束）时自动释放，这点比fcntl()更省心
真正难处理的是长时间持有锁的场景，比如大文件导出卡住，这时检测到锁之后，得决定是重试、排队还是报错——flock() 本身不提供锁等待队列或超时回调。
