Laravel任务调度？调度命令怎样设置？-Laravel-PHP中文网

Laravel任务调度？调度命令怎样设置？

畫卷琴夢

发布： 2025-09-18 11:57:02

原创

1024人浏览过

Laravel任务调度通过app/Console/Kernel.php中的schedule方法定义任务，支持Artisan命令、闭包、系统命令和队列任务，结合Crontab每分钟运行schedule:run来触发，可设置daily、hourly等频率及复杂规则如weeklyOn、withoutOverlapping，并可通过日志、onOneServer、ping监控等方式调试和优化。

laravel任务调度？调度命令怎样设置？

Laravel 任务调度，简单来说，就是让你像设置闹钟一样，定时执行一些 PHP 代码。至于调度命令，那得看你想怎么个“定时”法了。

使用 Laravel 的任务调度器，你可以将原本需要在服务器上手动运行的脚本，或者需要通过 Crontab 设置的定时任务，统一管理起来，方便维护和查看。

解决方案

Laravel 的任务调度核心在于

app/Console/Kernel.php

登录后复制

文件。在这个文件的

schedule

登录后复制

方法里，你可以定义你的调度任务。

基本步骤：

定义任务： 首先，你需要确定你要执行什么任务。这可以是一个 Artisan 命令，也可以是一个闭包函数，甚至是一个操作系统命令。
注册任务： 在
```
schedule
```
登录后复制
方法中，使用
```
$schedule
```
登录后复制
对象注册你的任务，并指定执行频率。
配置 Crontab： 最后，你需要配置服务器的 Crontab，让 Laravel 的调度器能够定期运行。

举个例子：

假设你要每天凌晨 1 点执行一个名为

backup:database

登录后复制

的 Artisan 命令，你可以这样写：

// app/Console/Kernel.php

protected function schedule(Schedule $schedule)
{
    $schedule->command('backup:database')
             ->dailyAt('01:00');
}

登录后复制

这行代码的意思是，每天凌晨 1 点，执行

php artisan backup:database

登录后复制

命令。

常用的调度方法：

```
daily()
```
登录后复制
: 每天执行
```
hourly()
```
登录后复制
: 每小时执行
```
weekly()
```
登录后复制
: 每周执行
```
monthly()
```
登录后复制
: 每月执行
```
cron($expression)
```
登录后复制
: 使用 Crontab 表达式自定义执行频率，比如
```
cron('0 0 * * *')
```
登录后复制
表示每天凌晨 0 点执行。
```
everyMinute()
```
登录后复制
: 每分钟执行 (不推荐，除非有特殊需求)

别忘了在服务器上配置 Crontab，添加以下条目：

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

登录后复制

这个 Crontab 条目表示每分钟运行一次

php artisan schedule:run

登录后复制

命令，Laravel 会检查是否有需要执行的任务，并执行它们。

副标题1

Laravel 任务调度支持哪些复杂的调度规则？

除了常见的

daily

登录后复制

、

hourly

登录后复制

之外，Laravel 调度器还支持更复杂的调度规则。例如：

指定星期/日期： 你可以使用
```
weeklyOn()
```
登录后复制
、
```
monthlyOn()
```
登录后复制
方法指定任务在每周/每月的哪一天执行。
```
$schedule->command('emails:send')
         ->weeklyOn(1, '13:00'); // 每周一 13:00 执行
```
登录后复制
执行环境判断： 你可以使用
```
environments()
```
登录后复制
方法指定任务只在特定的环境下执行，比如只在生产环境执行。
```
$schedule->command('emails:send')
         ->daily()
         ->environments('production');
```
登录后复制
防止任务重叠： 如果你的任务执行时间比较长，可以使用
```
withoutOverlapping()
```
登录后复制
方法防止任务重叠执行。

百度·度咔剪辑
度咔剪辑，百度旗下独立视频剪辑App

3

查看详情
```
$schedule->command('emails:send')
         ->daily()
         ->withoutOverlapping();
```
登录后复制
还可以指定锁的过期时间：
```
$schedule->command('emails:send')
         ->daily()
         ->withoutOverlapping(3600); // 锁 3600 秒
```
登录后复制
维护模式下的执行： 你可以使用
```
evenInMaintenanceMode()
```
登录后复制
方法让任务在维护模式下也能执行。这个通常用于一些必须在维护期间运行的任务，比如数据库迁移。
```
$schedule->command('emails:send')
         ->daily()
         ->evenInMaintenanceMode();
```
登录后复制

副标题2

如何调试 Laravel 任务调度？如果任务没有按时执行怎么办？

调试任务调度，是个让人头疼的问题。首先，检查你的 Crontab 是否配置正确。你可以尝试手动运行

php artisan schedule:run

登录后复制

命令，看看是否有任务被执行。

如果任务没有按时执行，可以尝试以下方法：

检查日志： Laravel 默认会将调度任务的输出写入日志文件。检查
```
storage/logs/laravel.log
```
登录后复制
文件，看看是否有错误信息。你也可以在调度任务中使用
```
sendOutputTo()
```
登录后复制
方法将输出写入到指定的文件。
```
$schedule->command('emails:send')
         ->daily()
         ->sendOutputTo('/path/to/output.log');
```
登录后复制
使用
```
thenPing()
```
登录后复制
方法： 你可以使用
```
thenPing()
```
登录后复制
方法在任务执行完成后发送一个 HTTP 请求到指定的 URL，用于监控任务的执行情况。
```
$schedule->command('emails:send')
         ->daily()
         ->thenPing('https://example.com/ping');
```
登录后复制
检查服务器时区： 确保服务器的时区设置正确。Laravel 默认使用
```
config/app.php
```
登录后复制
文件中
```
timezone
```
登录后复制
配置项指定的时区。
检查任务是否被禁用： 你可以使用
```
when()
```
登录后复制
方法根据条件判断是否执行任务。检查你的条件是否正确。
```
$schedule->command('emails:send')
         ->daily()
         ->when(function () {
             return true; // 总是执行
         });
```
登录后复制
使用
```
onOneServer()
```
登录后复制
方法： 如果你在多台服务器上运行 Laravel 应用，可以使用
```
onOneServer()
```
登录后复制
方法确保任务只在一台服务器上执行。
```
$schedule->command('emails:send')
         ->daily()
         ->onOneServer();
```
登录后复制

副标题3

除了 Artisan 命令，Laravel 任务调度还能执行哪些类型的任务？

除了 Artisan 命令，Laravel 任务调度还可以执行以下类型的任务：

闭包函数： 你可以直接在
```
schedule
```
登录后复制
方法中定义一个闭包函数来执行任务。
```
$schedule->call(function () {
    DB::table('users')->delete();
})->daily();
```
登录后复制
操作系统命令： 你可以使用
```
exec()
```
登录后复制
方法执行操作系统命令。
```
$schedule->exec('node /path/to/script.js')
         ->daily();
```
登录后复制
注意：执行操作系统命令需要谨慎，确保命令的安全性。
队列任务： 你可以使用
```
job()
```
登录后复制
方法将任务推送到队列中执行。
```
$schedule->job(new ProcessPodcast)->daily();
```
登录后复制

调用外部 URL： 你可以使用

pingBefore()

登录后复制

和

thenPing()

登录后复制

方法在任务执行前后调用外部 URL，用于监控任务的执行情况。

$schedule->command('emails:send')
         ->daily()
         ->pingBefore('https://example.com/ping-before')
         ->thenPing('https://example.com/ping-after');

登录后复制

以上就是Laravel任务调度？调度命令怎样设置？的详细内容，更多请关注php中文网其它相关文章！