傳統的程序執行流程一般是 即時|同步|串行的，在某些場景下，會存在并發低，吞吐量低，響應時間長等問題。在大型系統中，一般會引入消息隊列的組件，將流程中部分任務抽離出來放入消息隊列，并由專門的消費者做針對性的處理，從而降低系統耦合度，提高系統性能和可用性。
一般來說，可以抽離的任務具有以下的特點：
-
允許延后|異步|并行處理 （相對于傳統的 即時|同步|串行 的執行方式）
-
允許延后：
搶購活動時，先快速緩沖有限的參與人數到消息隊列，后續再排隊處理實際的搶購業務； -
允許異步：
業務處理過程中的郵件，短信等通知 -
允許并行：
用戶支付成功之后，郵件通知，微信通知，短信通知可以由多個不同的消費者并行執行，通知到達的時間不要求先后順序。
-
允許延后：
-
允許失敗和重試
- 強一致性的業務放入核心流程處理
- 無一致性要求或最終一致即可的業務放入隊列處理
thinkphp-queue 是thinkphp 官方提供的一個消息隊列服務，它支持消息隊列的一些基本特性：
- 消息的發布，獲取，執行，刪除，重發，失敗處理，延遲執行，超時控制等
- 隊列的多隊列， 內存限制 ，啟動，停止，守護等
- 消息隊列可降級為同步執行
thinkphp-queue 內置了 Redis，Database，Topthink ，Sync這四種驅動。本文主要介紹 thinkphp-queue 結合其內置的 redis 驅動的使用方式和基本原理。
一、簡單使用示例
1.1 安裝 thinkphp-queue
composer install thinkphp-queue
1.2 搭建消息隊列的存儲環境
- 使用 Redis
安裝并啟動 Redis 服務 (詳見:http://www.lxweimin.com/p/34dd90fda917)
1.3 配置消息隊列的驅動
根據選擇的存儲方式，在\application\extra\queue.php這個配置文件中，添加消息隊列對應的驅動配置
return [
'connector' => 'Redis', // Redis 驅動
'expire' => 60, // 任務的過期時間，默認為60秒; 若要禁用，則設置為 null
'default' => 'default', // 默認的隊列名稱
'host' => '127.0.0.1', // redis 主機ip
'port' => 6379, // redis 端口
'password' => '', // redis 密碼
'select' => 1, // 使用哪一個 db，默認為 db0
'timeout' => 0, // redis連接的超時時間
'persistent' => false, // 是否是長連接
// 'connector' => 'Database', // 數據庫驅動
// 'expire' => 60, // 任務的過期時間，默認為60秒; 若要禁用，則設置為 null
// 'default' => 'default', // 默認的隊列名稱
// 'table' => 'jobs', // 存儲消息的表名，不帶前綴
// 'dsn' => [],
// 'connector' => 'Topthink', // ThinkPHP內部的隊列通知服務平臺 ，本文不作介紹
// 'token' => '',
// 'project_id' => '',
// 'protocol' => 'https',
// 'host' => 'qns.topthink.com',
// 'port' => 443,
// 'api_version' => 1,
// 'max_retries' => 3,
// 'default' => 'default',
// 'connector' => 'Sync', // Sync 驅動，該驅動的實際作用是取消消息隊列，還原為同步執行
];
1.4 消息的創建與推送
我們在業務控制器中創建一個新的消息，并推送到 helloJobQueue 隊列
新增 \application\index\controller\JobTest.php 控制器，在該控制器中添加 actionWithHelloJob 方法
<?php
namespace app\index\controller;
use think\Queue;
class JobTest
{
/*
* 測試隊列action
* */
public function actionWithHelloJob(){
// 1.當前任務將由哪個類來負責處理。
// 當輪到該任務時，系統將生成一個該類的實例，并調用其 fire 方法
$jobHandlerClassName = 'app\index\job\Hello@fire';
// 2.當前任務歸屬的隊列名稱，如果為新隊列，會自動創建
$jobQueueName = "helloJobQueue";
// 3.當前任務所需的業務數據 . 不能為 resource 類型，其他類型最終將轉化為json形式的字符串
// ( jobData 為對象時，需要在先在此處手動序列化，否則只存儲其public屬性的鍵值對)
$jobData = [ 'name' => 'test'.rand(), 'password'=>rand()] ;
// 4.將該任務推送到消息隊列，等待對應的消費者去執行
$time2wait = strtotime('2018-09-08 11:15:00') - strtotime('now'); // 定時執行
$isPushed = Queue::later($time2wait, $jobHandlerClassName , $jobData , $jobQueueName );
// database 驅動時，返回值為 1|false ; redis 驅動時，返回值為 隨機字符串|false
if( $isPushed !== false ){
echo date('Y-m-d H:i:s') . " a new Hello Job is Pushed to the MQ"."<br>";
}else{
echo 'Oops, something went wrong.';
}
}
}
- 除了
Queue::push( jobHandlerClassName , jobData , jobQueueName );這種方式之外，還可以直接傳入Queue::push( jobHandlerObject ,null , jobQueueName );這時，需要在jobHandlerObject中定義一個handle()方法，消息隊列在執行到該任務時會自動反序列化該對象，并調用其handle()方法。 該方式的缺點是無法傳入自定義數據。
1.5 消息的消費與刪除
編寫 Hello 消費者類，用于處理 helloJobQueue 隊列中的任務
新增 \application\index\job\Hello.php 消費者類，并編寫其 fire() 方法
<?php
/**
* 文件路徑： \application\index\job\Hello.php
* 這是一個消費者類，用于處理 helloJobQueue 隊列中的任務
*/
namespace app\index\job;
use think\queue\Job;
use think\Db;
class Hello {
/**
* fire方法是消息隊列默認調用的方法
* @param Job $job 當前的任務對象
* @param array|mixed $data 發布任務時自定義的數據
*/
public function fire(Job $job,$data){
// 如有必要,可以根據業務需求和數據庫中的最新數據,判斷該任務是否仍有必要執行.
$isJobStillNeedToBeDone = $this->checkDatabaseToSeeIfJobNeedToBeDone($data);
if(!$isJobStillNeedToBeDone){
$job->delete();
return;
}
$isJobDone = $this->doHelloJob($data);
if ($isJobDone) {
//如果任務執行成功， 記得刪除任務
$job->delete();
}else{
if ($job->attempts() > 3) {
//通過這個方法可以檢查這個任務已經重試了幾次了
$job->delete();
// 也可以重新發布這個任務
//$job->release(2); //$delay為延遲時間，表示該任務延遲2秒后再執行
}
}
}
/**
* 有些消息在到達消費者時,可能已經不再需要執行了
* @param array|mixed $data 發布任務時自定義的數據
* @return boolean 任務執行的結果
*/
private function checkDatabaseToSeeIfJobNeedToBeDone($data){
return true;
}
/**
* 根據消息中的數據進行實際的業務處理
* @param array|mixed $data 發布任務時自定義的數據
* @return boolean 任務執行的結果
*/
private function doHelloJob($data) {
// 根據消息中的數據進行實際的業務處理...
// test
Db::name('admin')->insert([
'name'=>$data['name'],
'password'=>$data['password']
]);
return true;
}
}
1.6 發布任務
在瀏覽器中訪問 http://localhost/test/public/index.php/index/job_test/actionWithHelloJob 可以看到消息推送成功。
image.png
1.7 處理任務
切換當前終端窗口的目錄到項目根目錄下，執行
php think queue:work --queue helloJobQueue
可以看到執行的結果類似如下:
image.png
同時打開 redis 可視化工具
Redis Desktop Manager （ps:附上百度網盤下載鏈接：鏈接：https://pan.baidu.com/s/1-k79ZEGD77EtUQFolJosXA 密碼：xcfm）
image.png
- 可見由于我設置了定時執行，所以隊列處于待執行狀態。當執行時間到了，隊列會自動執行。
至此，我們成功地經歷了一個消息的 創建 -> 推送 -> 消費 -> 刪除 的基本流程
二、詳細介紹
介紹 thinkphp-queue 的詳細使用方法。如配置介紹，基本原理，各種特殊情況的處理等
注：在此篇文章不做詳細說明，如需了解請參鑒
https://github.com/coolseven/notes/blob/master/thinkphp-queue/README.md
