時間範囲制限

タスクの実行を 1 日の特定の時間帯に制限するには、between を使用します:

$schedule->command('reminders:send')     
               ->hourly()                    
               ->between('7:00', '22:00');

または # を使用します。 ##unlessBetween タスクの期間を除外するメソッド:

$schedule->command('reminders:send')              
      ->hourly()                    
      ->unlessBetween('23:00', '4:00');

when メソッドを使用して、ベースにします。テスト結果に基づいてタスクを実行します。つまり、指定されたクロージャが true を返した場合、タスクの実行を妨げる他の制約がない限り、タスクは実行を続けます:

$schedule->command('emails:send')->daily()->when(function () { 
   return true;
 });

skip メソッドは、when メソッドの逆のプロセスとみなすことができます。 skip メソッドが true を返した場合、タスクは実行されません:

$schedule->command('emails:send')->daily()->skip(function () {
    return true;
 });

when メソッドを使用する場合、すべて が true を返した場合、タスクは実行されます。

environments メソッドは、特定の環境でのみタスクを実行するために使用できます:

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

timezone メソッドを使用すると、タスクが特定のタイム ゾーンで実行されるように指定できます。

$schedule->command('report:generate')      
   ->timezone('America/New_York')        
   ->at('02:00')

ファイルで scheduleTimezone メソッドを定義できます。このメソッドは、スケジュールされたすべてのタスクに割り当てる必要があるデフォルトのタイム ゾーンを返す必要があります:

/**
 * 获取默认情况下应为预定事件使用的时区。
 *
 * @return \DateTimeZone|string|null
 */
 protected function scheduleTimezone(){  
   return 'America/Chicago';
 }

withoutOverlapping

$schedule->command('emails:send')->withoutOverlapping();

withoutOverlapping メソッドが特に役立ちます。 必要に応じて、指定した時間範囲に対して「重複なし」ロックを指定できます。デフォルトでは、ロックは 24 時間後に期限切れになります。

$schedule->command('emails:send')->withoutOverlapping(10);

タスクは 1 つのサーバーでのみ実行されます

{note} この機能を使用するには、アプリケーションのデフォルトのキャッシュ ドライバーが memcached または redis である必要があります。さらに、すべてのサーバーは同じ中央キャッシュ サーバーを使用して通信する必要があります。

アプリケーションが複数のサーバーで実行される場合は、スケジュールされたタスクを 1 つのサーバーでのみ実行するように制限する必要がある場合があります。毎週金曜日の夜に新しいレポートを生成するスケジュールがあるとします。タスク スケジューラが 3 台のサーバーで実行される場合、タスクは 3 台のサーバーで実行され、3 つのレポートが生成されます。これは良くない！

タスクを単一サーバーで実行する必要があることを示すには、スケジュールされたタスクを定義するときに onOneServer メソッドを使用します。タスクを取得した最初のサーバーは、他のサーバーが同じタスクを同時に実行できないようにアトミック ロックを生成します。

$schedule->command('report:generate')             
   ->fridays()                
   ->at('17:00')                
   ->onOneServer();

バックグラウンド タスク

デフォルトでは、同時にスケジュールされた複数のコマンドは順番に実行されます。実行時間の長いコマンドがある場合、後続のコマンドの開始が予想より遅くなる可能性があります。したがって、バックグラウンドでコマンドを同時に実行したい場合は、runInBackground メソッドを使用できます。

$schedule->command('analytics:report')      
   ->daily()         
   ->runInBackground();

メンテナンスモード

Laravelのキュータスクはメンテナンスモードでは実行されません。スケジュール設定タスクが、サーバー上で完了しない可能性のあるプロジェクトに干渉することを望まないからです。ただし、スケジュールされたタスクをメンテナンス モードで強制的に実行したい場合は、evenInMaintenanceMode メソッドを使用できます:

$schedule->command('emails:send')->evenInMaintenanceMode();

タスク出力

Laravel スケジューラーは、スケジュールされたタスク出力を処理するための便利なメソッドをいくつか提供します。まず、sendOutputTo メソッドを使用して、後で検査できるようにファイルに出力します。

$schedule->command('emails:send')    
     ->daily()         
     ->sendOutputTo($filePath);

出力 を特定のファイルに追加したい場合は、次のようにすることができます。 appendOutputTo メソッドを使用します。

$schedule->command('emails:send')     
    ->daily()         
    ->appendOutputTo($filePath);

emailOutputTo メソッドを使用すると、指定したメールボックスに出力を送信できます。電子メールを使用して送信する前に、Laravel の電子メール サービスを設定する必要があります:

$schedule->command('foo')   
      ->daily()         
      ->sendOutputTo($filePath)        
      ->emailOutputTo('foo@example.com');

{note} emailOutputTo、sendOutputTo、および appendOutputToメソッドは command と exec に固有です。

before と after## を使用します #メソッドでは、スケジュールされたタスクの実行前または後に特定のコードを実行できます:

$schedule->command('emails:send')   
      ->daily()         
      ->before(function () {         
          // Task is about to start...      
            })      
      ->after(function () {       
           // Task is complete...      
         });

Ping URL

pingBefore メソッドと thenPing メソッドを使用すると、タスクの実行前または後に指定された URL に ping を実行できます。このメソッドは、外部サービス (Laravel Envoyer など) に通知する場合に特に役立ちます。

$schedule->command('emails:send')      
   ->daily()         
   ->pingBefore($url)         
   ->thenPing($url);

指定された条件が true の場合にのみ使用できます。 pingBeforeIf および thenPingIf メソッドは、指定された URL に ping を送信します。

$schedule->command('emails:send')      
   ->daily()         
   ->pingBeforeIf($condition, $url)         
   ->thenPingIf($condition, $url);

すべての ping メソッドには、Guzzle HTTP ライブラリが必要です。 Composer を使用して、Guzzle をプロジェクトに追加できます。

composer require guzzlehttp/guzzle

PHP中国語ウェブサイト

ホームページコース記事に質問辞書マニュアルダウンロード検索 APPダウンロード