Coroutine::create
最后更新于：2022-04-02 06:25:42
# Coroutine::create
[TOC]
创建一个新的协程，并立即执行。
~~~
function Swoole\Coroutine::create(callable $function, ...$args) : int|false;
function go(callable $function, ...$args) : int|false; // 短名API
~~~
## 参数
* `$function`协程执行的代码，必须为`callable`，系统能创建的协程总数量受限于`server->max_coroutine`设置
## 返回值
* 创建失败返回`false`
* 创建成功返回协程的`ID`
由于底层会优先执行子协程的代码，因此只有子协程挂起时，`Coroutine::create`才会返回，继续执行当前协程的代码。
在`2.1.0`或更高版本中如果开启了`swoole.use_shortname`，可以直接使用`go`关键词创建新的协程。
~~~
go(function () {
$db = new Co\MySQL();
$server = array(
'host' => '127.0.0.1',
'user' => 'root',
'password' => 'root',
'database' => 'test',
);
$db->connect($server);
$result = $db->query('SELECT * FROM userinfo WHERE id = 3');
var_dump($result);
});
~~~
## 执行顺序
在一个协程中使用`go`嵌套创建新的协程。因为`Swoole`的协程是单线程模型，因此：
* 使用`go`创建的子协程会优先执行，子协程执行完毕或挂起时，将重新回到父协程向下执行代码
* 如果子协程挂起后，父协程退出，不影响子协程的执行
~~~
go(function() {
go(function () {
co::sleep(3.0);
go(function () {
co::sleep(2.0);
echo "co[3] end\n";
});
echo "co[2] end\n";
});
co::sleep(1.0);
echo "co[1] end\n";
});
~~~
## 协程开销
协程需要创建单独的内存栈，在`PHP-7.2`版本中底层会分配`8K`的`stack`来存储协程的变量，`zval`的尺寸为`16`字节，因此`8K`的`stack`最大可以保存`512`个变量。协程栈内存占用超过`8K`后`ZendVM`会自动扩容。
协程退出时会释放申请的`stack`内存。
> `PHP-7.1`、`PHP-7.0`默认会分配`256K`栈内存
> 可调用`Co::set(['stack_size' => 4096])`修改默认的栈内存尺寸
';