Laravel如何设置定时任务（Cron Job）_Laravel调度器与任务计划配置-Laravel-PHP中文网

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

php中文网

发布： 2025-12-07 13:04:02

原创

248人浏览过

Laravel通过单一Cron条目触发调度器，任务逻辑集中定义在Kernel.php中，支持定时执行命令、闭包或脚本，并可设置环境限制与日志输出，提升维护性。

laravel如何设置定时任务（cron job）_laravel调度器与任务计划配置

在 Laravel 中设置定时任务非常简单，Laravel 提供了强大的任务调度功能，只需要配置一次系统的 Cron 条目，之后所有的任务调度都可以通过代码来管理。这比直接写多个 shell 的 Cron 更清晰、更易维护。

Laravel 使用一个单一的 Cron 条目来驱动应用内的任务调度。你需要在服务器上添加以下 Cron 条目：

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

这条命令每分钟执行一次 Laravel 的调度运行器，检查是否有需要运行的任务。注意替换 /path-to-your-project 为你的 Laravel 项目根目录路径。

Laravel 的任务调度定义在 app/Console/Kernel.php 文件中的 schedule() 方法里。你可以在这里注册各种调度任务。

例如，你想每天凌晨 2 点清理缓存，可以这样写：

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

登录后复制

常见调度方式包括：

除了 Artisan 命令，你还可以调度闭包函数或外部脚本。

Primeshot

专业级AI人像摄影工作室

示例：每十分钟执行一个闭包任务

$schedule->call(function () {
    \Log::info('定时任务执行成功');
})->everyTenMinutes();

登录后复制

运行系统脚本：

$schedule->exec('php /path/to/script.php')->daily();

登录后复制

也可以结合环境判断，避免在开发环境运行：

$schedule->command('emails:send')->daily()->environments(['production']);

登录后复制

建议为每个任务设置输出重定向，便于调试和监控：

$schedule->command('backup:run')
         ->daily()
         ->sendOutputTo(storage_path('logs/backup.log'));

登录后复制

如果想在任务完成后发送通知，可使用 thenPing() 或 onSuccess() / onFailure() 钩子（需配合健康监测服务）。

基本上就这些。Laravel 调度器让定时任务变得集中、可控，不再依赖分散的 Cron 配置，大大提升可维护性。只要确保系统 Cron 正确指向 schedule:run，其余逻辑全在 PHP 中定义，清晰又安全。

以上就是Laravel如何设置定时任务（Cron Job）_Laravel调度器与任务计划配置的详细内容，更多请关注php中文网其它相关文章！

大家都在看：