基于 Swoole 的微信掃碼登錄

隨著微信的普及，掃碼登錄方式越來越被現在的應用所使用，它因為不用去記住密碼，只要有微信號即可方便快捷登錄，微信的開放平臺原生就有支持掃碼登錄的功能，不過大部分人還是在用公眾平臺，所以掃碼登錄只能自行實作，這里基于微信公眾平臺的帶引數臨時二維碼，并且結合 Swoole 的 WebSocket 服務實作掃碼登錄，大體流程如下：

1. 客戶端打開登錄界面，連接到 WebSocket 服務
2. WebScoket 服務生成帶引數二維碼回傳給客戶端
3. 用戶掃描展示的帶引數二維碼
4. 微信服務器回呼掃碼事件并通知開發者服務器
5. 開發者服務器通知 WebSocket 服務
6. WebSocket 服務通知客戶端登錄成功

連接 WebSocket 服務

安裝完 Swoole 之后，我們需用使用到 WebSocket 服務，新建一個 WebSocket 服務非常簡單：

1 $server = new swoole_websocket_server("0.0.0.0", 1099);
2 $server->on('open', function (swoole_websocket_server $server, $request) use ($config){
3     echo "server: handshake success with fd{$request->fd}\n";
4 });
5 
6 $server->on('message', function (swoole_websocket_server $server, $frame) {
7 
8 });

這里的 message 回呼其實用不到，因為都是服務端下發訊息的，但是必須設定一個，設定的埠號如果低于 1024 則必須要有 root 權限，服務器記得去防火墻開啟該埠，

生成帶引數二維碼

WebSocket 服務在客戶端連接成功后，需要生成一張微信的帶引數二維碼回傳給客戶端展示：

1 $server->on('open', function (swoole_websocket_server $server, $request) use ($config){
2     $app = Factory::officialAccount($config['wechat']);
3     $result = $app->qrcode->temporary($request->fd, 120);
4     $url = $app->qrcode->url($result['ticket']);
5     $server->push($request->fd, json_encode([
6         'message_type'    =>  'qrcode_url',
7         'url'       =>  $url
8     ]));
9 });

我們在 open 回呼中，生成一張臨時的二維碼，二維碼的場景值就是客戶端連接的檔案描述符，這樣就可以保證每個客戶端的唯一性，有效時間設定為 120 秒，防止一張二維碼被多次掃碼使用，訊息 push 到客戶端的時候必須要 json，方便客戶端處理，客戶端代碼也很簡單：

1 const socket = new WebSocket('ws://127.0.0.1:1099');
2     socket.addEventListener('message', function (event) {
3         var data = https://www.cnblogs.com/a609251438/p/JSON.parse(event.data);
4         if (data.message_type == 'qrcode_url'){
5             $('#qrcode').attr('src', data.url);
6         }
7     });

回呼掃碼事件

在客戶端展示二維碼后，需要提示用戶掃碼，對于用戶掃臨時的二維碼，微信會觸發相應的回呼事件，我們需要在該回呼事件中處理用戶的掃碼行為，其中我們需要用到微信傳遞過來的一些引數：

FromUserName    發送方帳號（一個OpenID）
MsgType         訊息型別，event
Event           事件型別，subscribe
EventKey        事件 KEY 值，qrscene_為前綴，后面為二維碼的引數值

這里要注意一點：微信已關注掃碼推送的 EventKey 是沒有 qrscene_ 前綴的，只有未關注掃碼然后關注才有，

收到微信回呼后我們首先要根據不同的事件型別做不同處理：

 1 if ($message['MsgType'] == 'event'){
 2     if ($message['Event'] == 'subscribe'){  //關注
 3         return $this->subscribe($message);
 4     }
 5     if ($message['Event'] == 'unsubscribe') {  //取消關注
 6         return $this->unsubscribe($message);
 7     }
 8     if ($message['Event'] == 'SCAN'){   //已關注掃碼
 9         return $this->scan($message);
10     }
11 }else{
12     return "您好！歡迎使用 SwooleWechat 掃描登錄";
13 }

這里只講解一個關注事件的業務邏輯，其他根據需要自行編碼：

 1 public function subscribe($message){
 2     $eventKey = intval(str_replace('qrscene_', '', $message['EventKey']));
 3     $openId = $message['FromUserName'];
 4     $user = $this->app->user->get($openId);
 5     $this->notify(json_encode([
 6         'type'  =>  'scan',
 7         'fd'    =>  $eventKey,
 8         'nickname'  =>  $user['nickname']
 9     ]));
10     $count = $this->count($openId);
11     $msgTemp = "%s，登錄成功！\n這是你第%s次登錄，玩的開心！";
12     return sprintf($msgTemp, $user['nickname'], $count);
13 }

這里的 EventKey 實際上就是連接 WebSocket 的客戶端檔案描述符，獲取到掃碼用戶的 OPEN_ID, 根據用戶的 OPEN_ID 獲取用戶資訊，通知 WebSocket 服務，回應文本訊息給微信，
這里一個比較麻煩的點就是如何通知 WebSocket 服務，我們知道處理微信回呼的代碼是是不在 WebSocket 服務上的，那么不同 Server 間如何通信呢？Swoole 官方給出的解決方案有兩個：

1. 額外監聽一個 UDP 埠
2. 使用 swoole_client 作為客戶端訪問 Server

這里我們選擇第二個方案，Swoole 1.8 版本支持一個 Server 監聽多個埠，我們在 WebSocket 服務新增監聽一個 TCP 的埠：

1 $tcp_server = $server->addListener('0.0.0.0', 9999, SWOOLE_SOCK_TCP);
2 $tcp_server->set([]);
3 $tcp_server->on('receive', function ($serv, $fd, $threadId, $data) {
4 
5 });

主服務器是 WebSocket 或 Http 協議，新監聽的 TCP 埠默認會繼承主 Server 的協議設定，必須單獨呼叫 set 方法設定新的協議才會啟用新協議

然后我們就可以在掃碼回呼的行程中去通知 WebSocket 服務：

1 public function notify($message){
2     $client = new swoole_client(SWOOLE_SOCK_TCP);
3     if (!$client->connect('127.0.0.1', $this->config['notify_port'], -1)) {
4         return "connect failed. Error: {$client->errCode}\n";
5     }
6     $ret = $client->send($message);
7 }

通知登錄成功

在 WebSocket 服務收到登錄成功的通知后，就可以根據需要處理一下用戶資訊，然后把用戶資訊傳遞給客戶端的瀏覽器展示結果，還記得我們剛剛新監聽的 TCP 埠嗎？就可以在 receive 事件中處理：

 1 $tcp_server->on('receive', function ($serv, $fd, $threadId, $data) {
 2     $data = json_decode($data, true);
 3     if ($data['type'] == 'scan'){
 4         $serv->push($data['fd'], json_encode([
 5             'message_type'    =>  'scan_success',
 6             'user'  =>  $data['nickname']
 7         ]));
 8     }
 9     $serv->close($fd);
10 });

最后登錄的界面：
發圖太麻煩，自行去 http://wechat.sunnyshift.com/index.php 測驗地址看，

總結

整個程序并不難，主要的兩個難點就是對應連接用戶的掃碼用戶、不同 Server 之間的通信，我們的解決辦法就是把連接的檔案描述符作為臨時二維碼場景值 (這里也可以采用 Redis 來存盤映射關系)、監聽新的 TCP 埠來接受通知訊息，可以訪問 http://wechat.sunnyshift.com/index.php 試試看，記得要用電腦打開，

標籤：PHP

上一篇：實作websocket 主動訊息推送，用laravel+Swoole

下一篇：PHP bcpow BC數學函式