laravel通过单一Cron条目触发调度器,任务逻辑集中定义在Kernel.php中,支持定时执行命令、闭包或脚本,并可设置环境限制与日志输出,提升维护性。

在 Laravel 中设置定时任务非常简单,Laravel 提供了强大的任务调度功能,只需要配置一次系统的 Cron 条目,之后所有的任务调度都可以通过代码来管理。这比直接写多个 shell 的 Cron 更清晰、更易维护。
1. 配置系统 Cron 触发 Laravel 调度器
Laravel 使用一个单一的 Cron 条目来驱动应用内的任务调度。你需要在服务器上添加以下 Cron 条目:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
这条命令每分钟执行一次 Laravel 的调度运行器,检查是否有需要运行的任务。注意替换 /path-to-your-project 为你的 Laravel 项目根目录路径。
2. 定义任务计划(Task Scheduling)
Laravel 的任务调度定义在 app/console/Kernel.php 文件中的 schedule() 方法里。你可以在这里注册各种调度任务。
例如,你想每天凌晨 2 点清理缓存,可以这样写:
protected function schedule(Schedule $schedule) { $schedule->command('cache:clear')->daily()->at('02:00'); }
常见调度方式包括:
- ->hourly():每小时执行
- ->daily():每天零点执行
- ->dailyAt(’10:30′):每天指定时间执行
- ->weekly():每周执行
- ->monthly():每月执行
- ->everyFiveMinutes():每五分钟执行
- ->weekdays():仅工作日执行
3. 运行自定义命令或闭包任务
除了 Artisan 命令,你还可以调度闭包函数或外部脚本。
示例:每十分钟执行一个闭包任务
$schedule->call(function () { Log::info('定时任务执行成功'); })->everyTenMinutes();
运行系统脚本:
$schedule->exec('php /path/to/script.php')->daily();
也可以结合环境判断,避免在开发环境运行:
$schedule->command('emails:send')->daily()->environments(['production']);
4. 输出与日志记录
建议为每个任务设置输出重定向,便于调试和监控:
$schedule->command('backup:run') ->daily() ->sendOutputTo(storage_path('logs/backup.log'));
如果想在任务完成后发送通知,可使用 thenPing() 或 onSuccess() / onFailure() 钩子(需配合健康监测服务)。
基本上就这些。Laravel 调度器让定时任务变得集中、可控,不再依赖分散的 Cron 配置,大大提升可维护性。只要确保系统 Cron 正确指向 schedule:run,其余逻辑全在 PHP 中定义,清晰又安全。
以上就是Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置的详细内容,更多请关注php中文网其它相关文章!