信息发布→ 登录 注册 退出

Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置

发布时间:2025-12-07

点击量:
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 中定义,清晰又安全。

标签:# 你可以  # 并可  # 只需要  # 自定义  # 这条  # 可以通过  # 你还  # 你想  # 多个  # php  # 在这里  # console  # 闭包  # NULL  # 开发环境  # ai  # app  # laravel  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!