本文详细介绍了在php中如何利用文件锁机制，特别是`flock`函数，来有效防止通过cron job频繁调用的脚本出现重复执行的问题。通过存储进程id（pid）和确保锁文件的健壮性清理，本教程提供了一种可靠且易于实现的方法，以应对长时间运行脚本可能导致的并发冲突，确保任务的唯一性执行。
理解PHP脚本重复执行的风险
在服务器管理中，Cron Job是定期执行自动化任务的关键工具。然而，当一个长时间运行的PHP脚本被Cron Job频繁调度（例如每5秒一次），而其执行时间可能超过调度间隔时，就可能出现同一脚本的多个实例同时运行的情况。这不仅可能导致资源浪费、数据不一致，甚至引发系统崩溃。因此，实现一种机制来确保脚本的单实例运行至关重要。
使用文件锁（flock）实现单实例控制
PHP的flock函数提供了一种简单而有效的文件锁定机制，可以用于控制脚本的并发执行。其核心思想是：当一个脚本实例开始执行时，它尝试在一个预定义的文件上获取独占锁。如果成功，则继续执行任务；如果失败，则表明已有其他实例正在运行，当前实例应立即退出。
基本文件锁实现
以下是一个基础的文件锁实现示例：
<?php
$lockFile = "cron.lock"; // 定义锁文件路径
$fp = fopen($lockFile, "a+"); // 以读写模式打开或创建锁文件
// 尝试获取独占锁（LOCK_EX）且非阻塞（LOCK_NB）
if (flock($fp, LOCK_EX | LOCK_NB)) {
echo "任务已启动\n";
// 这里放置你的长时间运行脚本逻辑
// 模拟脚本执行时间
sleep(2);
// 任务完成后释放锁
flock($fp, LOCK_UN);
echo "任务完成并释放锁\n";
} else {
echo "任务已在运行中，当前实例退出\n";
exit; // 如果无法获取锁，则退出
}
fclose($fp); // 关闭文件句柄，这将自动释放锁（如果之前未显式释放）
?>代码解析：
立即学习“PHP免费学习笔记（深入）”；
- fopen($lockFile, "a+"): 打开或创建名为 cron.lock 的文件。a+ 模式允许读写，并在文件不存在时创建它。
- flock($fp, LOCK_EX | LOCK_NB): 这是关键一步。
- LOCK_EX: 请求一个独占锁，这意味着其他进程不能获取该文件的任何锁。
- LOCK_NB: 非阻塞模式。如果无法立即获取锁，flock会立即返回 false，而不是等待锁被释放。
- 如果flock返回 true，表示成功获取锁，脚本可以安全执行其主要逻辑。
- flock($fp, LOCK_UN): 在脚本任务完成后，显式释放锁。
- fclose($fp): 关闭文件句柄。即使没有显式调用 LOCK_UN，关闭文件句柄也会自动释放该进程持有的所有锁。
增强文件锁机制：PID记录与健壮性清理
为了提高文件锁的可靠性和可调试性，我们可以引入以下改进：
- 记录进程ID (PID)：在锁文件中写入当前脚本的进程ID。这对于外部监控和调试非常有用，可以知道哪个进程持有锁。
- 健壮性清理 (unlink)：在脚本正常完成时，不仅释放锁，还删除锁文件。这确保了文件系统的清洁，并防止因意外崩溃而遗留的锁文件（尽管fclose通常会释放锁，但删除文件更彻底）。
改进后的文件锁实现
<?php
$lockFile = "/tmp/cron_task.lock"; // 建议使用/tmp或其他临时目录
$pid = getmypid(); // 获取当前进程ID
$fp = fopen($lockFile, "a+");
if ($fp === false) {
error_log("无法打开或创建锁文件: " . $lockFile);
exit(1); // 无法创建锁文件，直接退出
}
// 尝试获取独占锁（LOCK_EX）且非阻塞（LOCK_NB）
if (flock($fp, LOCK_EX | LOCK_NB)) {
// 成功获取锁
ftruncate($fp, 0); // 清空文件内容
fwrite($fp, $pid . "\n"); // 写入当前进程ID
fflush($fp); // 确保内容写入磁盘
echo "任务已启动，PID: " . $pid . "\n";
// 这里放置你的长时间运行脚本逻辑
// 模拟脚本执行时间
sleep(rand(5, 20)); // 模拟不同执行时间
echo "任务完成，PID: " . $pid . "\n";
// 任务完成后释放锁并删除锁文件
flock($fp, LOCK_UN);
fclose($fp);
unlink($lockFile); // 删除锁文件，确保彻底清理
} else {
// 无法获取锁，说明任务已在运行
$existingPid = trim(file_get_contents($lockFile)); // 尝试读取已运行任务的PID
echo "任务已在运行中，由PID: " . ($existingPid ?: "未知") . " 持有锁。当前实例退出。\n";
fclose($fp); // 关闭文件句柄
exit(0); // 正常退出，因为这不是错误
}
?>改进点解析：
- $lockFile = "/tmp/cron_task.lock";: 建议将锁文件放置在 /tmp 或其他适合存放临时文件的目录，以避免污染应用目录，并确保所有Cron Job都能访问。
- $pid = getmypid();: 获取当前PHP脚本的进程ID。
- if ($fp === false) { ... }: 增加对 fopen 失败的错误处理，例如文件权限问题。
- ftruncate($fp, 0); fwrite($fp, $pid . "\n"); fflush($fp);: 在获取锁后，清空锁文件内容，写入当前进程ID，并强制刷新缓冲区，确保PID立即写入文件。
- unlink($lockFile);: 在脚本成功执行并释放锁后，删除锁文件。这是确保系统清洁和防止潜在僵尸锁文件的关键步骤。
- $existingPid = trim(file_get_contents($lockFile));: 当无法获取锁时，尝试读取锁文件中记录的PID，提供更详细的调试信息。
注意事项与最佳实践
- 锁文件路径： 确保锁文件路径是可写且对所有Cron Job实例都可见的。/tmp 目录通常是合适的选择。
- 错误处理： 增加对文件操作（fopen, fwrite, unlink）的错误检查，以应对文件系统问题。
- 意外终止： 即使脚本意外终止（例如，PHP致命错误或被kill），操作系统通常会在进程结束后自动释放文件锁。然而，unlink操作可能不会被执行，导致锁文件残留。在这种情况下，下次运行时，如果锁文件存在但没有实际进程持有锁，flock仍会失败。一种更高级的策略是结合PID检查：如果锁文件存在，读取其中的PID，检查该PID对应的进程是否仍在运行。如果不在运行，则可以安全地删除旧锁文件并重新获取锁。但对于大多数场景，上述改进后的方案已足够。
- 日志记录： 结合日志系统记录脚本的启动、结束、重复运行等信息，便于后续排查问题。
- 替代方案： 对于更复杂的分布式系统或需要更高并发控制的场景，可以考虑使用数据库锁、缓存系统（如Redis）的分布式锁或消息队列。但对于单服务器上的PHP Cron Job，文件锁通常是最简单有效的解决方案。
总结
通过在PHP Cron Job脚本中实现健壮的文件锁机制，我们能够有效防止脚本重复执行，确保任务的唯一性和数据的一致性。结合记录进程ID和彻底清理锁文件，不仅提升了脚本的可靠性，也为故障排查提供了宝贵的信息。这种方法简单易行，是管理长时间运行PHP任务的强大工具。
