PHPSocket.IO知識學習整理

一、服務端和客戶端連接

1、創建一個SocketIO服務端

<?php
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
use PHPSocketIO\SocketIO;

// 創建socket.io服務端，監聽3120端口
$io = new SocketIO(3120);
// 當有客戶端連接時打印一行文字
$io->on('connection', function($socket)use($io){
  echo "new connection coming\n";
});

Worker::runAll();

2、創建一個客戶端

<script src='https://cdn.bootcss.com/socket.io/2.0.3/socket.io.js'></script>
<script>
// 如果服務端不在本機，請把127.0.0.1改成服務端ip
var socket = io('http://127.0.0.1:3120');
// 當連接服務端成功時觸發connect默認事件
socket.on('connect', function(){
    console.log('connect success');
});
</script>

二、自定義事件

socket.io主要是通過事件來進行通訊交互的。

socket連接除了自帶的connect，message，disconnect三個事件以外，在服務端和客戶端開發者可以自定義其它事件。

服務端和客戶端都通過emit方法觸發對端的事件。

例如下面的代碼在服務端定義了一個chat message事件，事件參數為$msg。

<?php
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
use PHPSocketIO\SocketIO;

$io = new SocketIO(3120);
// 當有客戶端連接時
$io->on('connection', function($socket)use($io){
  // 定義chat message事件回調函數
  $socket->on('chat message', function($msg)use($io){
    // 觸發所有客戶端定義的chat message from server事件
    $io->emit('chat message from server', $msg);
  });
});
Worker::runAll();

客戶端通過下面的方法觸發服務端的chat message事件。

<script src='//cdn.bootcss.com/socket.io/1.3.7/socket.io.js'></script>
<script>
// 連接服務端
var socket = io('http://127.0.0.1:3120');
// 觸發服務端的chat message事件
socket.emit('chat message', '這個是消息內容...');
// 服務端通過emit('chat message from server', $msg)觸發客戶端的chat message from server事件
socket.on('chat message from server', function(msg){
    console.log('get message:' + msg + ' from server');
});
</script>

三、workerStart事件

phpsocket.io提供了workerStart事件回調，也就是當進程啟動后准備好接受客戶端鏈接時觸發的回調。 一個進程生命周期只會觸發一次。可以在這里設置一些全局的事情，比如開一個新的Worker端口等等。

require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
use PHPSocketIO\SocketIO;

$io = new SocketIO(9120);

// 監聽一個http端口，通過http協議訪問這個端口可以向所有客戶端推送數據(url類似http://ip:9191?msg=xxxx)
$io->on('workerStart', function()use($io) {
    $inner_http_worker = new Worker('http://0.0.0.0:9191');
    $inner_http_worker->onMessage = function($http_connection, $data)use($io){
        if(!isset($_GET['msg'])) {
            return $http_connection->send('fail, $_GET["msg"] not found');
        }
        $io->emit('chat message', $_GET['msg']);
        $http_connection->send('ok');
    };
    $inner_http_worker->listen();
});

// 當有客戶端連接時
$io->on('connection', function($socket)use($io){
  // 定義chat message事件回調函數
  $socket->on('chat message', function($msg)use($io){
    // 觸發所有客戶端定義的chat message from server事件
    $io->emit('chat message from server', $msg);
  });
});

Worker::runAll();

四、分組

socket.io提供分組功能，允許向某個分組發送事件，例如向某個房間廣播數據。

1、加入分組（一個連接可以加入多個分組）

$socket->join('group name');

2、離開分組（連接斷開時會自動從分組中離開）

$socket->leave('group name');

五、向客戶端發送事件的各種方法

$io是SocketIO對象。$socket是客戶端連接

$data可以是數字和字符串，也可以是數組。當$data是數組時，客戶端會自動轉換為javascript對象。

同理如果客戶端向服務端emit某個事件傳遞的是一個javascript對象，在服務端接收時會自動轉換為php數組。

1、向當前客戶端發送事件

$socket->emit('event name', $data);

2、向所有客戶端發送事件

$io->emit('event name', $data);

3、向所有客戶端發送事件，但不包括當前連接。

$socket->broadcast->emit('event name', $data);

4、向某個分組的所有客戶端發送事件

$io->to('group name')->emit('event name', $data);

六、獲取客戶端ip

$io->on('connection', function($socket)use($io){
        var_dump($socket->conn->remoteAddress);
});

七、關閉鏈接

$socket->disconnect();

八、限制連接域名

當我們想指定特定域名的頁面才能連接，可以用$io->origins方法來設置域名白名單。

$io = new SocketIO(2020);
$io->origins('http://example.com:8080');

多個域名時用空格分隔，類似

$io = new SocketIO(2020);
$io->origins('http://workerman.net http://www.workerman.net');

九、支持SSL(https wss)

SSL支持有兩種方法，workerman原生和nginx代理

<?php
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
use PHPSocketIO\SocketIO;

// 傳入ssl選項，包含證書的路徑
$context = array(
    'ssl' => array(
        'local_cert'  => '/your/path/of/server.pem',
        'local_pk'    => '/your/path/of/server.key',
        'verify_peer' => false,
    )
);
$io = new SocketIO(2120, $context);

$io->on('connection', function($socket)use($io){
  echo "new connection coming\n";
});

Worker::runAll();

注意：
1、證書是要驗證域名的，所以客戶端鏈接時要指定域名才能順利的建立鏈接。
2、客戶端連接時不能再用http方式，要改成https類似下面這樣。

<script>
var socket = io('https://yoursite.com:2120');
//.....
</script>

本文摘自：https://github.com/walkor/phpsocket.io/tree/master/docs/zh