package_length_func
设置长度解析函数,支持C++
或PHP
的2
种类型的函数。长度函数必须返回一个整数。
- 返回
0
,长度数据不足,需要接收更多数据 - 返回
-1
,数据错误,底层会自动关闭连接 - 返回包长度值(包括包头和包体的总长度),底层会自动将包拼好后返回给回调函数
使用方法
实现原理是先读取一小部分数据,在这段数据内包含了一个长度值。然后将这个长度返回给底层。然后由底层完成剩余数据的接收并组合成一个包进行dispatch
。
PHP长度解析函数
由于ZendVM
不支持运行在多线程环境,因此底层会自动使用Mutex
互斥锁对PHP
长度函数进行加锁,避免并发执行PHP
函数。在1.9.3
或更高版本可用。
请勿在长度解析函数中执行阻塞
IO
操作,可能导致所有Reactor
线程发生阻塞
$serv = new Swoole\Server("127.0.0.1", 9501);
$serv->set(array(
'open_length_check' => true,
'dispatch_mode' => 1,
'package_length_func' => function ($data) {
if (strlen($data) < 8) {
return 0;
}
$length = intval(trim(substr($data, 0, 8)));
if ($length <= 0) {
return -1;
}
return $length + 8;
},
'package_max_length' => 2000000, //协议最大长度
));
$serv->on('receive', function (swoole_server $serv, $fd, $from_id, $data)
{
var_dump($data);
echo "#{$serv->worker_id}>> received length=" . strlen($data) . "\n";
});
$serv->start();
C++长度解析函数
在其他PHP扩展中,使用swoole_add_function
注册长度函数到Swoole
引擎中。
C++长度函数调用时底层不会加锁,需要调用方自行保证线程安全性
实例:
#include <string>
#include <iostream>
#include "swoole.h"
using namespace std;
int test_get_length(swProtocol *protocol, swConnection *conn, char *data, uint32_t length);
void register_length_function(void)
{
swoole_add_function((char *) "test_get_length", (void *) test_get_length);
return SW_OK;
}
int test_get_length(swProtocol *protocol, swConnection *conn, char *data, uint32_t length)
{
printf("cpp, size=%d\n", length);
return 100;
}