写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 原子写文件与文件锁
系统与运维 通用 PHP 7.4+

原子写文件与文件锁

三个并发场景:计数器用 flock、配置用临时文件 + rename、日志用追加写,分别给出正确写法。

完整代码

PHP
<?php
/** 1. 计数器:读-改-写必须加锁 */
function counter_inc(string $file): int
{
    $fh = fopen($file, 'c+');
    flock($fh, LOCK_EX);
    $n = (int)stream_get_contents($fh) + 1;
    ftruncate($fh, 0);
    rewind($fh);
    fwrite($fh, (string)$n);
    fflush($fh);
    flock($fh, LOCK_UN);
    fclose($fh);
    return $n;
}

/** 2. 配置文件:写临时文件再原子替换 */
function atomic_write(string $file, string $content): bool
{
    $tmp = $file . '.tmp' . getmypid();
    if (file_put_contents($tmp, $content, LOCK_EX) === false) {
        return false;
    }
    return rename($tmp, $file);
}

/** 3. 日志:追加 + 排他锁 */
function append_log(string $file, string $line): void
{
    file_put_contents($file, $line . "\n", FILE_APPEND | LOCK_EX);
}

怎么用

  1. 计数器用于统计访问量、下载次数这类「读出来加一再写回」的场景。
  2. 配置文件、缓存清单用 atomic_write,避免别的进程读到半个文件。
  3. 日志用 append_log,多进程写同一文件不会互相覆盖。

注意

  • flock 是建议锁,只对同样使用 flock 的进程有效。
  • rename 在同一文件系统内是原子的;跨分区会变成复制,失去原子性。
  • 高并发计数器用 Redis 的 INCR,别用文件。

相关源码