Laravel隊列（Queue）功能使用指南：配置、定義任務與執行

M66 2025-07-02

引言

隊列（Queue）是一種常見的異步處理機制，在Web開發中具有重要的作用。 Laravel框架提供了強大的隊列功能，可以方便地處理各種後台任務，如發送郵件、生成報表和處理大數據等。本文將詳細介紹如何在Laravel框架中使用隊列功能，包括隊列配置、任務定義和執行等，並給出相應的代碼示例。

配置隊列

在Laravel框架中，隊列的配置非常簡單。首先，打開配置文件config/queue.php，設置隊列驅動器和相應的連接參數。 Laravel支持多種隊列驅動器，如數據庫、Redis、Beanstalkd等。以下示例以使用數據庫驅動器為例進行說明：

 <span class="fun">&#39;connections&#39; => [ &#39;database&#39; => [ &#39;driver&#39; => &#39;database&#39;, &#39;table&#39; => &#39;jobs&#39;, &#39;queue&#39; => &#39;default&#39;, &#39;retry_after&#39; => 90, ], ],</span>

在上述配置中，driver指定隊列驅動器為數據庫驅動，table指定存儲隊列任務的數據表名，queue指定默認隊列的名稱，retry_after設置任務執行失敗後的重試時間。

定義任務

在Laravel框架中，隊列任務（Job）是以類的方式定義的，通常存放在app/Jobs目錄下。我們創建一個簡單的隊列任務，用於發送郵件。

首先，使用Artisan命令生成隊列任務模板：

 <span class="fun">php artisan make:job SendEmailJob</span>

生成成功後，會在app/Jobs目錄下生成一個名為SendEmailJob的類文件。打開該類文件，代碼如下：

 <span class="fun">namespace AppJobs; use IlluminateBusQueueable; use IlluminateContractsQueueShouldQueue; use IlluminateFoundationBusDispatchable; use IlluminateQueueInteractsWithQueue; use IlluminateQueueSerializesModels; class SendEmailJob implements ShouldQueue { use Dispatchable, InteractsWithQueue, Queueable, SerializesModels; public function __construct() {} public function handle() { // 發送郵件的邏輯代碼} }</span>

在這個類中，我們可以定義發送郵件的邏輯代碼。需要注意的是，由於隊列任務是異步執行的，因此需要將ShouldQueue接口作為類的實現。同時，其他特徵（Trait）Dispatchable、InteractsWithQueue、Queueable、SerializesModels提供了對隊列操作和對象序列化的支持。

任務入隊

在Laravel框架中，任務入隊是通過調用dispatch函數來實現的。以下是將SendEmailJob任務入隊的示例代碼：

 <span class="fun">use AppJobsSendEmailJob; dispatch(new SendEmailJob());</span>

上述代碼將SendEmailJob任務添加到默認隊列中。如果希望指定隊列名稱，可以使用onQueue方法：

 <span class="fun">use AppJobsSendEmailJob; dispatch((new SendEmailJob())->onQueue(&#39;emails&#39;));</span>

如果希望任務延遲執行，可以使用delay方法：

 <span class="fun">use AppJobsSendEmailJob; $job = (new SendEmailJob())->delay(Carbon::now()->addMinutes(10)); dispatch($job);</span>

執行隊列任務

在Laravel框架中，隊列任務可以通過兩種方式執行：同步執行和異步執行。

同步執行（Sync Driver）

同步執行是指任務在當前請求中立即執行，不經過隊列驅動器的處理。只需將配置文件config/queue.php中的默認隊列驅動器設置為“sync”即可：

 <span class="fun">&#39;default&#39; => env(&#39;QUEUE_DRIVER&#39;, &#39;sync&#39;),</span>

此時，任務將在當前請求中立即執行。

異步執行

異步執行是指任務由隊列驅動器負責處理和執行。在config/queue.php中，可以將默認隊列驅動器設置為其他驅動器，如“database”。

 <span class="fun">&#39;default&#39; => env(&#39;QUEUE_DRIVER&#39;, &#39;database&#39;),</span>

然後，使用以下命令來監聽並執行隊列任務：

 <span class="fun">php artisan queue:work</span>

此時，任務將被添加到隊列中，並由queue:work命令監聽並執行。

總結

通過上述步驟，我們可以在Laravel框架中實現隊列功能，並以發送郵件的任務為例，提供了相應的代碼示例。隊列功能可以幫助開發者更好地處理後台任務，提高系統的並發能力和響應速度。在實際開發中，還可以結合其他功能和第三方服務，實現更加高效的功能。希望本文對您在使用Laravel框架時能夠有所幫助。