信息发布→ 登录 注册 退出

Laravel中的任务调度(Task Scheduling)如何设置定时任务

发布时间:2025-11-19

点击量:
Laravel通过单一Cron入口触发调度器,自动执行app/Console/Kernel.php中定义的任务,如定时运行命令、脚本或闭包,并支持输出日志、条件控制和时间限制,简化了任务调度管理。

Laravel 的任务调度功能让你可以通过代码轻松管理定时任务,无需手动在服务器上配置复杂的 Cron 条件。你只需要在 Laravel 中定义调度逻辑,然后在服务器上添加一条 Cron 入口,框架会自动处理任务的运行时机。

1. 任务调度的基本原理

Laravel 使用 Artisan 命令和内置的调度器来管理定时任务。所有调度逻辑集中在 app/Console/Kernel.php 文件中的 schedule() 方法里。Laravel 会通过一个单一的 Cron 条目触发调度检查,再由框架判断哪些任务需要执行。

服务器只需设置一次系统级 Cron:

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

这条命令每分钟运行一次 Laravel 调度器,由 Laravel 决定具体执行哪些任务。

2. 定义定时任务

打开 app/Console/Kernel.php 文件,在 schedule() 方法中添加你的任务。

常见任务示例:

  • 每五分钟执行一次命令$schedule->command('inspire')->everyFiveMinutes();
  • 每天凌晨两点运行$schedule->command('emails:send')->daily()->at('2:00');
  • 每周一上午九点执行$schedule->command('backup:run')->weekly()->mondays()->at('9:00');
  • 每小时执行一次闭包任务(注意:闭包任务不能跨进程安全执行,建议封装成命令): $schedule->call(function () { \Log::info('每小时记录一次'); })->hourly();
  • 执行系统脚本$schedule->exec('node /home/script.js')->daily();

3. 设置任务输出与日志

你可以将命令的输出重定向到文件,便于调试或记录。

  • 保存输出: $schedule->command('emails:send')->daily()->sendOutputTo('/storage/logs/email-sent.log');
  • 追加并发送错误信息: $schedule->command('emails:send')->daily()->appendOutputTo('/storage/logs/mix.log');

4. 控制任务运行条件

使用 when() 方法可以添加运行条件,只有条件返回 true 才执行。

$schedule->command('emails:send')->daily()->when(function () { return ! app()->isLocal(); });

上面的例子表示:只在非本地环境时发送邮件。

还可以限制任务在特定时间段运行:

$schedule->command('maintenance:enable')->daily()->between('23:00', '4:00');

5. 测试调度任务

开发时想立即测试任务?可以手动运行:

php artisan schedule:run

这会检查所有定义的任务,并执行当前应运行的那些。

查看即将运行的任务列表(Laravel 8+ 支持):

php artisan schedule:list

基本上就这些。只要写好调度逻辑,部署时确保服务器的 Cron 正确指向 schedule:run,Laravel 就会帮你精准控制任务执行。

标签:# php  # laravel  # js  # node  # app  # ai  # NULL  # 封装  # 闭包  # 并发  
在线客服
服务热线

服务热线

4008888355

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

截屏,微信识别二维码

打开微信

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