Runtime

在4.1.0版本中，底层增加一个新的特性，可以在运行时动态将基于php_stream实现的扩展、PHP网络客户端代码一键协程化。底层替换了ZendVM Stream的函数指针，所有使用php_stream进行socket操作均变成协程调度的异步IO。

目前有PHP原生Redis、PDO、MySQLi协程化的支持。

4.1版本仅支持tcp和unix两种stream类型 4.2版本增加了对udp、udg、unix、ssl、tls类型的支持 4.2.3版本以前存在FILE_HOOK覆盖include/require的BUG, 请通过Swoole\Runtime::enableCoroutine(true, SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_FILE);的方式屏蔽file hook

函数原型

  1. function Runtime::enableCoroutine(bool $enable = true, int $flags = SWOOLE_HOOK_ALL);
  • $enable：打开或关闭协程
  • $flags：选择要Hook的类型，可以多选，默认为全选。仅在$enable = true时有效
$flags参数在4.2或更高版本可用，请参考：开关选项

可用列表

  • redis扩展
  • 使用mysqlnd模式的pdo、mysqli扩展，如果未启用mysqlnd将不支持协程化
  • soap扩展
  • file_get_contents、fopen
  • stream_socket_client (predis)
  • stream_socket_server
  • fsockopen

不可用列表

  • mysql：底层使用libmysqlclient
  • curl：底层使用libcurl （即不能使用CURL驱动的Guzzle）
  • mongo：底层使用mongo-c-client
  • pdo_pgsql
  • pdo_ori
  • pdo_odbc
  • pdo_firebird

使用实例

  1. Swoole\Runtime::enableCoroutine();
  3. go(function () {
  4.     $redis = new redis;
  5.     $retval = $redis->connect("127.0.0.1", 6379);
  6.     var_dump($retval, $redis->getLastError());
  7.     var_dump($redis->get("key"));
  8.     var_dump($redis->set("key", "value2"));
  9.     var_dump($redis->get("key"));
  10.     $redis->close();
  11. });

方法摆放位置

调用方法后当前进程内全局生效, 一般放在整个项目最开头以获得100%覆盖的效果, 协程内外会自动切换模式, 不影响PHP原生环境使用.

注意: 不建议放在onRequest等回调中开启, 会多次调用造成不必要的调用开销.