最轻量可靠的方式是使用文件锁（flock）实现互斥控制，因其无需额外依赖、跨平台兼容、内核级原子性保障，且进程退出后锁自动释放；需用fopen打开专用锁文件并flock加锁，而非依赖锁文件内容。
在 Yii2 控制台应用中执行定时任务（如通过 crontab 调用 `yii command/run`）时，若任务执行时间长于调度间隔，就可能出现多个实例并发运行的问题。为避免重复执行导致数据错乱或资源冲突，最轻量、可靠的方式是使用 文件锁（flock） 实现互斥控制。
为什么选文件锁而不是数据库锁或 Redis 锁
控制台命令通常短平快、无状态，且不一定依赖数据库或缓存服务。文件锁无需额外依赖，跨平台兼容（Linux/macOS/Windows 均支持），内核级保证原子性，失败后也容易排查（直接看锁文件是否存在即可）。
注意：不要用 PHP 的 flock() 对普通文件加锁来判断“是否正在运行”——因为进程退出后锁自动释放，但锁文件本身可能残留；更稳妥的做法是用 flock() 锁定一个专用锁文件描述符，不依赖文件内容。
在 Yii2 控制台命令中嵌入 flock 逻辑
推荐在命令的 execute() 方法开头加入锁逻辑。示例代码如下：
use yii\console\Controller;
use yii\helpers\Console;
<p>class MyTaskController extends Controller
{
public function actionRun()
{
$lockFile = Yii::getAlias('@runtime/mytask.lock');</p><pre class="brush:php;toolbar:false;"> $fp = fopen($lockFile, 'c+');
if (!$fp) {
$this->stderr("无法创建锁文件：$lockFile\n", Console::FG_RED);
return self::EXIT_CODE_ERROR;
}
// 尝试非阻塞加锁
if (!flock($fp, LOCK_EX | LOCK_NB)) {
$this->stdout("任务已在运行，跳过本次执行。\n");
fclose($fp);
return self::EXIT_CODE_NORMAL;
}
// 加锁成功，继续执行业务逻辑
try {
$this->stdout("开始执行任务...\n");
// ✅ 这里放你的实际业务代码（如数据同步、清理等）
sleep(10); // 模拟耗时操作
$this->stdout("任务执行完成。\n");
} finally {
// 确保释放锁（fclose 自动解锁）
fclose($fp);
// 可选：删除锁文件（非必须，flock 不依赖文件存在）
@unlink($lockFile);
}
return self::EXIT_CODE_NORMAL;
}}
配合 crontab 使用的关键细节
- crontab 中调用命令时，确保工作目录正确（建议显式指定）：
* * * * * cd /var/www/myapp && php yii my-task/run >> /var/log/mytask.log 2>&1 - 锁文件路径务必使用绝对路径或 Yii 别名（如
@runtime），避免因 crontab 用户环境不同导致路径解析异常 - 不要在 shell 层再套用
flock命令（如flock -n /tmp/x.lock -- php yii ...），这会和 PHP 内部 flock 行为冲突，且不易统一管理 - 若任务异常崩溃未正常 fclose，锁仍会被系统自动释放（进程终止时 fd 关闭），所以不会永久死锁
进阶建议：增加锁超时与持有者标识
纯 flock 不记录谁加的锁、何时加的。如需监控或强制清理，可扩展为「带时间戳 + PID 的锁文件」：
- 加锁前写入当前时间与
getmypid() - 检测到锁存在时，读取文件内容，若时间超过阈值（如 30 分钟）且进程已不存在，可主动清理并重试加锁
- 该逻辑适合对稳定性要求极高的场景，一般任务用基础 flock 已足够
