从 Swoole4 版本开始,提供了一键协程化的功能,采用 Hook 原生 PHP 函数的方式实现协程客户端,通过一行代码就可以让原来的同步 IO 的代码变成可以协程调度的异步 IO,即一键协程化。
目前有两种方式设置要 Hook 的函数范围:
代码语言:javascript复制SwooleCoroutine::set(['hook_flags'=> SWOOLE_HOOK_ALL]);
SwooleRuntime::enableCoroutine(SWOOLE_HOOK_ALL);
同时从v4.6.0
版本开始,协程容器中默认开启所有 Hook,即 SWOOLE_HOOK_ALL
:
use SwooleRuntime;
use function SwooleCoroutinerun;
run(function () {
assert(Runtime::getHookFlags() === SWOOLE_HOOK_ALL);
});
那么有两种方式可以设置,具体使用哪种方式来设置呢?
先来看一段代码:
代码语言:javascript复制基于 Swoole
v4.7.1
版本,并开启了--enable-swoole-curl
use SwooleCoroutine;
use SwooleRuntime;
function hook_dump()
{
var_dump([
'file' => (Runtime::getHookFlags() & SWOOLE_HOOK_FILE) === SWOOLE_HOOK_FILE,
'native' => (Runtime::getHookFlags() & SWOOLE_HOOK_NATIVE_CURL) === SWOOLE_HOOK_NATIVE_CURL,
'curl' => (Runtime::getHookFlags() & SWOOLE_HOOK_CURL) === SWOOLE_HOOK_NATIVE_CURL,
]);
}
Coroutinerun(function () {
hook_dump();
$flags = SWOOLE_HOOK_ALL ^ (SWOOLE_HOOK_FILE | SWOOLE_HOOK_NATIVE_CURL | SWOOLE_HOOK_CURL);
Coroutine::set(['hook_flags' => $flags]);
hook_dump();
Runtime::enableCoroutine($flags);
hook_dump();
});
是不是觉得应该输出为:
代码语言:javascript复制array(3) {
["file"]=>
bool(true)
["native"]=>
bool(true)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(false)
["native"]=>
bool(false)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(false)
["native"]=>
bool(false)
["curl"]=>
bool(false)
}
但实际上输出结果却为:
代码语言:javascript复制array(3) {
["file"]=>
bool(true)
["native"]=>
bool(true)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(true)
["native"]=>
bool(true)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(false)
["native"]=>
bool(false)
["curl"]=>
bool(false)
}
这个时候就会以为是Coroutine::set(['hook_flags' => $flags]);
没生效,是 Bug 吗?当然不是 Bug 了。
分开来测试一下:
代码语言:javascript复制use SwooleCoroutine;
use SwooleRuntime;
function hook_dump()
{
var_dump([
'file' => (Runtime::getHookFlags() & SWOOLE_HOOK_FILE) === SWOOLE_HOOK_FILE,
'native' => (Runtime::getHookFlags() & SWOOLE_HOOK_NATIVE_CURL) === SWOOLE_HOOK_NATIVE_CURL,
'curl' => (Runtime::getHookFlags() & SWOOLE_HOOK_CURL) === SWOOLE_HOOK_NATIVE_CURL,
]);
}
$flags = SWOOLE_HOOK_ALL ^ (SWOOLE_HOOK_FILE | SWOOLE_HOOK_NATIVE_CURL | SWOOLE_HOOK_CURL);
Coroutine::set(['hook_flags' => $flags]);
Coroutinerun(function () {
hook_dump();
Coroutine::set(['hook_flags' => SWOOLE_HOOK_ALL]);
hook_dump();
});
再增加一个协程嵌套进行测试
代码语言:javascript复制Coroutinerun(function () {
hook_dump();
Coroutine::set(['hook_flags' => SWOOLE_HOOK_ALL]);
go(function () {
hook_dump();
});
});
输出发现全是false
,也就是说在协程中通过Coroutine::set
动态设置 flags 不会生效
array(3) {
["file"]=>
bool(false)
["native"]=>
bool(false)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(false)
["native"]=>
bool(false)
["curl"]=>
bool(false)
}
将协程容器中的Coroutine::set
换为Runtime::enableCoroutine
进行测试
Coroutinerun(function () {
hook_dump();
Runtime::enableCoroutine(SWOOLE_HOOK_ALL);
hook_dump();
go(function () {
hook_dump();
});
});
发现结果是生效的。
代码语言:javascript复制array(3) {
["file"]=>
bool(false)
["native"]=>
bool(false)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(true)
["native"]=>
bool(true)
["curl"]=>
bool(false)
}
array(3) {
["file"]=>
bool(true)
["native"]=>
bool(true)
["curl"]=>
bool(false)
}
综上所述,可以得到以下结论:
Runtime::enableCoroutine()
可以在服务启动后 (运行时) 动态设置 flags,调用方法后当前进程内全局生效Coroutine::set()
可以理解为 PHP 的ini_set()
,需要在Server->start()
前或Coroutinerun()
前调用,否则设置的hook_flags
不会生效- 无论是
Coroutine::set()
还是Runtime::enableCoroutine()
的方式,都应该只调用一次,重复调用会被覆盖
即 Runtime::enableCoroutine()
支持动态设置 flags,而Coroutine::set()
的方式不支持。