Laravel定时任务怎么设置_Laravel Crontab调度器配置

Laravel通过单一系统cron触发调度内核，所有任务在app/Console/Kernel.php中定义，支持命令、闭包、脚本执行，可设置频率、环境、条件及防重叠，使用php artisan schedule:list查看和schedule:run测试，实现集中化、可维护的定时任务管理。

在Laravel中设置定时任务非常方便，Laravel自带了一个强大的任务调度器，允许你通过代码定义Crontab任务，而无需手动在服务器上配置多个cron条目。整个调度系统基于一个单一的服务器cron配置，所有任务由Laravel统一管理。

1. 配置系统Crontab

Laravel调度器依赖于系统级别的cron来触发调度内核。你需要在服务器上添加一条固定的cron条目：

这条命令每分钟执行一次Laravel的调度检查，由Laravel判断哪些任务需要运行。替换 /path-to-your-project 为你的项目根目录路径。

2. 定义调度任务（App\Console\Kernel.php）

所有定时任务都在 app/Console/Kernel.php 文件中的 schedule 方法里定义。

示例：每天凌晨1点执行某个命令

protected function schedule(Schedule $schedule)
{
    $schedule->command('inspire')->dailyAt('01:00');
}

常见调度频率方法：

• ->everyMinute() – 每分钟
• ->hourly() – 每小时
• ->daily() – 每天零点
• ->dailyAt('13:00') – 每天13:00
• ->weekly() – 每周
• ->monthly() – 每月
• ->timezone('Asia/Shanghai') – 设置时区

3. 执行闭包或自定义逻辑

除了Artisan命令，也可以直接调度PHP闭包：

$schedule->call(function () {
    // 清理缓存或处理数据
    \Cache::flush();
})->daily();

还可以调用脚本文件：

$schedule->exec('php /path/to/script.php')->hourly();

4. 设置运行环境和条件

你可以限制任务只在特定环境下运行：

$schedule->command('emails:send')->daily()->environments(['production']);

或者使用 when 添加运行条件：

$schedule->command('emails:send')->daily()->when(function () {
    return config('app.env') === 'production';
});

避免重叠执行（防止前一个任务未完成就启动下一个）：

$schedule->command('emails:send')->daily()->withoutOverlapping();

5. 查看和测试调度任务

你可以使用以下命令查看即将运行的任务：

在开发环境中测试任务是否会被正确调度。

要手动运行所有待执行任务（用于调试）：

基本上就这些。Laravel的调度器让Crontab管理变得集中、可版本控制且易于维护。只要确保服务器上那一条cron存在，其余全靠代码定义。不复杂但容易忽略。