33 Laravel框架入门教程 - 任务调度之使用计划任务

在上一篇中，我们介绍了如何创建调度任务。在这篇文章中，我们将深入探讨如何在 Laravel 中使用计划任务来执行这些调度任务。计划任务是自动化管理任务、定期运行代码的重要工具，能够显著提高开发效率。

使用计划任务

在 Laravel 中，计划任务是通过 schedule 方法在 app/Console/Kernel.php 文件中定义的。以下是几个关键步骤，帮助你在 Laravel 中创建和使用计划任务。

定义计划任务

打开 app/Console/Kernel.php 文件，在 schedule 方法内部，你可以定义你的调度任务。例如，要每天运行一次 SendEmail 命令，可以这样写：

protected function schedule(Schedule $schedule)
{
    $schedule->command('email:send')->daily();
}

在这个示例中，email:send 是你定义的 Artisan 命令，它会每天执行一次。

常用调度频率

Laravel 提供了多种调度频率，以下是一些常用的调度方法：

• ->everyMinute() - 每分钟执行一次
• ->hourly() - 每小时执行一次
• ->daily() - 每天执行一次
• ->weekly() - 每周执行一次
• ->monthly() - 每月执行一次
• ->timezone('Asia/Shanghai') - 设置时区

例如，下面的代码每小时在第 15 分钟运行任务：

$schedule->command('report:generate')->hourlyAt(15);

监控计划任务

为了监控调度任务的执行，Laravel 提供了 ->emailOutputTo() 方法。你可以将命令的输出通过邮件发送给管理员。

$schedule->command('email:send')->daily()->emailOutputTo('admin@example.com');

这样，每次任务执行后，输出结果都会发送到指定的邮箱。

处理任务失败

如果某个调度任务失败，你可能希望能够自动重试。可以使用 ->retryAfter() 方法来定义重试的间隔时间。例如，设置在任务失败后 5 分钟重新尝试：

$schedule->command('queue:restart')->everyFiveMinutes()->retryAfter(5);

示例：创建并调度一个邮件发送任务

下面我们来创建一个邮件发送命令，并将其添加到计划任务中：

1. 创建命令

首先，通过 Artisan 命令创建一个新的命令：

php artisan make:command SendEmail

在 app/Console/Commands/SendEmail.php 文件中，修改 handle 方法来编写发送邮件的逻辑：

public function handle()
{
    // 发送邮件的逻辑
    \Mail::to('user@example.com')->send(new \App\Mail\MyMail());
    $this->info('Email has been sent!');
}

2. 调度命令

然后，在 app/Console/Kernel.php 中，将这个命令添加到计划任务中：

protected function schedule(Schedule $schedule)
{
    $schedule->command('email:send')->daily();
}

3. 测试计划任务

在开发环境中，可以暂时调整调度的频率，例如设置为每分钟：

protected function schedule(Schedule $schedule)
{
    $schedule->command('email:send')->everyMinute();
}

运行计划任务

要使 Laravel 的计划任务生效，你需要设置系统任务调度，比如在 Linux 系统中，可以使用 cron。运行以下命令，打开 crontab 文件：

crontab -e

添加如下行，每分钟运行 Laravel 的计划任务调度器：

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

这里 /path-to-your-project/ 是你的 Laravel 项目的绝对路径。

总结

在本篇中，我们学习了如何使用 Laravel 的任务调度功能来自动化定期执行的任务。我们介绍了如何定义计划任务、监控任务执行结果、处理任务失败，并通过一个邮件发送的示例加深理解。

在下一篇文章中，我们将深入学习 RESTful API 的开发，特别是如何定义 RESTful 路由，希望你继续关注！

如果还有任何疑问，欢迎在评论区交流！