Laravel定时任务怎么设置_Laravel Crontab调度器配置_网络技术

发布时间 - 2025-12-15 00:00:00 点击率：次

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

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

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

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

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

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

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

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

常见调度频率方法：

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

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

还可以调用脚本文件：

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

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

$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();

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

php artisan schedule:list

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

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

php artisan schedule:run

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