Laravel通过Kernel.php定义计划任务，需配置系统Cron每分钟执行schedule:run，支持多种频率方法与日志记录，可手动测试任务生效情况。
如果您希望在 Laravel 应用中自动执行某些命令或脚本，例如定时清理日志、发送邮件通知或同步数据，可以通过配置计划任务来实现。Laravel 提供了强大的任务调度功能，允许您通过代码定义任务的执行频率和逻辑。
本文运行环境：MacBook Pro，macOS Sonoma
一、定义计划任务
在 Laravel 中，所有计划任务都定义在 app/Console/Kernel.php 文件的 schedule 方法中。该方法接收一个 Illuminate\Console\Scheduling\Schedule 对象，用于注册各种调度任务。
1、打开项目根目录下的 app/Console/Kernel.php 文件。
2、在 schedule 方法中使用 $schedule->command() 来调度 Artisan 命令，例如：
$schedule->command('inspire')->hourly();
3、也可以使用 $schedule->call() 调度闭包函数，例如：
$schedule->call(function () { DB::table('recent_users')->delete(); })->daily();
二、设置系统级 Cron 表达式
Laravel 的任务调度依赖于系统级别的 Cron 任务来触发框架内部的调度检查。因此需要在服务器上添加一条固定的 Cron 条目，以确保 Laravel 能够按时运行已定义的任务。
1、通过 SSH 登录到您的服务器并执行命令：crontab -e，进入 Cron 编辑模式。
2、添加以下一行指令，表示每分钟调用一次 Laravel 的调度器：
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
3、保存并退出编辑器，确认 Cron 服务已启动且正常运行。
三、配置不同的任务频率
Laravel 提供了丰富的链式方法来设定任务执行周期，您可以根据实际需求选择合适的频率方法。
1、使用 ->daily() 让任务每天凌晨执行一次。
2、使用 ->hourly() 每小时执行一次任务。
3、使用 ->everyFiveMinutes() 实现每五分钟执行一次。
4、使用 ->weekdays() 限制任务仅在工作日运行。
5、结合 ->when() 添加条件判断，只有满足条件时才执行任务。
四、记录任务输出与错误日志
为了便于调试和监控计划任务的执行情况，建议将任务的输出重定向到日志文件中，以便后续排查问题。
1、在定义任务时使用 ->sendOutputTo() 指定标准输出的日志路径，例如：
$schedule->command('emails:send')->daily()->sendOutputTo('/storage/logs/email-sent.log');
2、使用 ->appendOutputTo() 将输出追加写入日志文件而非覆盖。
3、通过 ->emailOutputOnFailure() 设置当任务失败时自动发送包含输出内容的邮件通知。
五、测试计划任务是否生效
在完成配置后，应验证任务是否能按预期执行，避免因配置错误导致任务未运行。
1、手动运行命令：php artisan schedule:run，触发当前应执行的任务。
2、查看 Laravel 日志文件 storage/logs/laravel.log 中是否有相关任务执行记录。
3、检查指定的输出日志文件是否存在，并确认其内容符合预期。
4、等待预定时间点到来，观察任务是否自动执行。
