{category}

Laravel - ジョブスケジューリング

delay()

ディレイ(キューとジョブ

意味 ジョブの実行を遅延させる


delay()とは?

delay()メソッドは、ジョブの実行を指定した時間だけ遅らせる機能を提供します。ジョブをキューに追加する際に、即時実行ではなく、将来の特定の時間に実行したい場合に使用します。

delay()の具体的な使い方

ジョブの遅延ディスパッチと条件付き遅延

use App\Jobs\ProcessPodcast;
use App\Models\Podcast;
use Illuminate\Support\Facades\Log;

class PodcastController extends Controller
{
    public function schedule(Podcast $podcast)
    {
        // 基本的な遅延ディスパッチ
        ProcessPodcast::dispatch($podcast)
            ->delay(now()->addMinutes(10));

        // 条件に基づく遅延ディスパッチ
        $delayMinutes = $podcast->isLong() ? 30 : 10;
        ProcessPodcast::dispatch($podcast)
            ->delay(now()->addMinutes($delayMinutes));

        Log::info("ポッドキャスト {$podcast->id} の処理が {$delayMinutes} 分後にスケジュールされました。");

        return response()->json(['message' => 'ポッドキャスト処理がスケジュールされました']);
    }
}

class Podcast extends Model
{
    public function isLong()
    {
        return $this->duration > 60; // 60分以上を長尺と定義
    }
}

👇出力結果

// ログファイルに記録される内容
[2023-06-01 16:00:00] local.INFO: ポッドキャスト 123 の処理が 30 分後にスケジュールされました。

// APIレスポンス
{
    "message": "ポッドキャスト処理がスケジュールされました"
}

この例では、ポッドキャスト処理ジョブを遅延ディスパッチする方法を示しています。基本的な10分後の遅延と、ポッドキャストの長さに応じて遅延時間を調整する条件付き遅延を実装しています。また、スケジューリング情報をログに記録し、APIレスポンスを返しています。

delay()に関するよくある質問

Q. delay()の引数に使える値は?
A. delay()メソッドの引数には、Carbonインスタンス、DateTimeインスタンス、または秒数を表す整数を使用できます。例えば、delay(60)は60秒後、delay(now()->addDay())は1日後にジョブを実行します。
Q. 遅延されたジョブをキャンセルできる?
A. はい、遅延されたジョブは実行される前にキャンセルできます。ジョブのIDを保存しておき、later()メソッドを使用してジョブを取得し、delete()メソッドを呼び出すことでキャンセルできます。
Q. サーバー再起動時の動作は?
A. 遅延ジョブはデータベースやRedisなどのバックエンドに保存されるため、サーバーが再起動しても失われません。スケジュールされた時間になると実行されます。ただし、使用しているキュードライバがこの機能をサポートしていることを確認してください。

delay()が学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか?
プログラミング単語帳には、Laravelのdelay()やShouldQueue、release()、onConnection()、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。

1日5分の暗記でプログラミンが身に付く!プログラミング単語帳 公式ストアで発売中!

HTML編、CSS編、JavaScript編、PHP編、Ruby編、その他単語編の6シリーズ分が公式ストアにて販売中です。気になった方はぜひ購入してみてください。


Laravelを学べる「プログラミング単語帳」アプリ

プログラミング単語帳がアプリになりました!Laravelはもちろん、10種類のプログラミング言語の中から、よく使われる単語をスマホで学習できます。

収録単語は2,000単語以上!
現在は、HTML、CSS、JavaScirpt、PHP、Laravel、Ruby、Python、MySQL、Linux、など10カテゴリーの単語帳が1つのアプリに収録されています。

いつでも、どこでも、隙間時間を有効活用して、プログラミングを効率的に学べるので、ぜひダウンロードしてみてください。

2024年7月アップデート情報:「Laravel」カテゴリーが追加されましました!

2024年8月アップデート情報:「MySQL」「Linux」カテゴリーが追加されましました!


関連するそのほかの単語

ShouldQueue

ジョブをキュー化するインターフェース

種類: キュー化インターフェース

release()

ジョブを再度キューに戻す

種類: ジョブ制御

onConnection()

ジョブの接続先を指定

種類: キュー設定

Route::apiResource()

APIリソースルート作成

種類: 高度なルーティング

Route::view()

直接ビューを表示

種類: 高度なルーティング