信息发布→ 登录 注册 退出

laravel如何配置任务调度(Cron Jobs)_Laravel任务调度配置方法

发布时间:2025-10-13

点击量:
Laravel任务调度只需配置一条每分钟执行的Cron,框架自动运行app/Console/Kernel.php中定义的任务,支持闭包、命令、脚本等多种类型,提供丰富的频率方法和日志记录功能,并可限制环境运行,简化定时任务管理。

Laravel 提供了强大的任务调度功能,让你可以通过 Artisan 命令轻松管理定时任务。你不再需要手动在服务器上配置多个 Cron 条目,只需要添加一条 Cron 记录指向 Laravel 的调度命令,框架会自动处理所有定义的任务。

1. 服务器上配置基础 Cron

要启用 Laravel 的任务调度,首先需要在你的服务器上设置一个 Cron 条目,让它每分钟运行一次 Laravel 的调度进程。

执行以下命令编辑服务器的 crontab:

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

其中 /path-to-your-project 是你的 Laravel 项目根目录。这条命令会每分钟检查是否有需要执行的计划任务。

2. 定义计划任务(Schedule)

Laravel 的任务调度定义在 app/Console/Kernel.php 文件中的 schedule 方法里。

你可以在这里注册各种类型的定时任务,例如闭包、Artisan 命令、系统命令等。

示例:每天凌晨 2 点备份数据库

protected function schedule(Schedule $schedule) { $schedule->command('backup:run')->daily()->at('02:00'); }

示例:每 5 分钟执行一次自定义任务

$schedule->call(function () { // 执行某些逻辑,比如清理缓存、同步数据等 })->everyFiveMinutes();

示例:执行系统脚本

$schedule->exec('/usr/local/bin/cleanup.sh')->daily();

3. 常用调度频率方法

Laravel 提供了很多链式方法来定义任务执行周期:

  • ->everyMinute():每分钟执行
  • ->everyFiveMinutes():每 5 分钟
  • ->everyTenMinutes():每 10 分钟
  • ->hourly():每小时
  • ->daily():每天零点
  • ->dailyAt('14:30'):每天指定时间
  • ->weekly():每周一凌晨
  • ->monthly():每月第一天
  • ->timezone('Asia/Shanghai'):设置时区

也可以使用 Cron 表达式自定义周期:

$schedule->command('inspire')->cron('0 0 * * *');

4. 任务输出与日志记录

你可以将任务的输出重定向到文件,便于调试和监控。

$schedule->command('emails:send')->daily()->output('/storage/logs/email.log');

使用 append() 可追加内容而不覆盖:

$schedule->command('emails:send')->daily()->appendOutputTo('/storage/logs/email.log');

如果想禁止输出,可使用 sendOutputTo 并指向 /dev/null

5. 任务环境限制

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

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

或使用 when 方法添加条件判断:

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

基本上就这些。只要配置好系统 Cron 并在 Kernel.php 中定义任务,Laravel 调度器就能自动运行,简洁又可靠。

标签:# 数据库  # 多个  # 就能  # 让你  # 在这里  # 自动运行  # 链式  # 自定义  # 器上  # 你可以  # 每分钟  # laravel  # function  # console  # append  # 闭包  # protected  # NULL  # ai  # app  # php  
在线客服
服务热线

服务热线

4008888355

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

截屏,微信识别二维码

打开微信

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