導入
Laravelのタスクスケジューラは、複雑なCron設定をコードベースで一元管理できる非常に便利な機能です。しかし、共用サーバーなどでデフォルトのPHPパスが古く、想定外のバージョンでスクリプトが実行されてエラーになるケースは現場で頻発します。本記事では、環境ごとのPHPパス問題をスマートに解決する方法と、スケジューラ運用の注意点を解説します。
基礎知識
Laravelのタスクスケジューラは、OS側のCronで「毎分」実行されることを前提に設計されています。サーバー側のCron設定で「 php /path/to/artisan schedule:run」と記述することで、Laravel内のKernel.phpで定義したスケジュールが評価されます。ここで重要なのは、Cronから呼び出されるPHPバイナリが、アプリケーションが想定しているバージョンと一致しているかという点です。
実装/解決策
レンタルサーバー等でPHPのバージョンが複数インストールされている場合、単純に「php」コマンドを叩くと古いシステムPHPが優先されることがあります。これを防ぐため、Laravelのタスクスケジューラで実行するコマンドに明示的にパスを指定するか、環境変数を用いてパスを制御するのがベストプラクティスです。
サンプルプログラム
以下のコードは、Kernel.phpでのスケジューリング例と、環境変数を利用した安全なコマンド実行の構成です。
// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
// 3時間おきにメール送信コマンドを実行する例
$schedule->command(‘emails:send’)
->cron(‘0 /3 ‘)
->withoutOverlapping(); // 多重実行を防ぐための重要な設定
}
// .env ファイルにPHPのフルパスを定義
// PHP_PATH=/usr/bin/php8.2
// 実行コマンドをカスタマイズする場合のKernel.php記述例
protected function schedule(Schedule $schedule)
{
$phpPath = env(‘PHP_PATH’, ‘php’);
// PHPパスを明示して外部コマンドを実行する場合
$schedule->exec(“{$phpPath} artisan custom:task-command”)
->dailyAt(’03:00′);
}
応用・注意点
1. Cronの実行頻度とスケジュールの整合性:
Laravelのスケジューラは、Cron自体が動いていないと作動しません。Cron設定が「1時間おき」の場合、Laravel側で「5分おき」のタスクを設定しても、Cronが動くタイミングでしか評価されません。基本は「毎分（ ）」でCronを設定しましょう。
2. PHP_PATHの管理:
上記のように.envでPHP_PATHを管理する場合、デプロイ先環境ごとに正しいパスを指定してください。which php コマンドをターミナルで実行すれば、現在適用されているパスを確認できます。
3. 多重実行の防止:
処理時間が長いタスクの場合、前回の処理が終わらないうちに次が始まってしまうことがあります。withoutOverlapping() メソッドをチェーンさせることで、排他制御（ロックファイルの作成）を行い、安全に運用することが現場では必須です。
4. ログの確認:
スケジューラが動かない場合、まずはCronの実行ログ（/var/log/cronなど）や、Laravelのstorage/logsを確認してください。また、>> /dev/null 2>&1 を設定していても、トラブルシューティング時は一時的にログを出力させてエラー内容を追跡できるようにしておくのが賢明です。