三十七、Swoole 基础学习笔记 - Swoole 协程 TCP/UDP 客户端
hi，我是温新，一名PHPer
文章基于 Swoole 5.0.1 版本编写。
学习目标：学习协程 TCP/UDP 服务器
说明：本篇文章结合官方文档编写及参考网络资料编写，虽非全部原创，但也是结合了自己的理解，若转载请附带本文 URL，编写不易，持续编写更不易，谢谢！
协程 TCP/UDP 客户端
Coroutine\Client 提供了 TCP、UDP、unixSocket 传输协议的 Sockt 客户端封装代码，使用时仅需 new Swoole\Coroutine\Client 即可。
实现原理
- 1、
Coroutine\Client的所有涉及网络请求的方法，Swoole都会进行协程调度，业务层无感知； - 2、使用方法同 Client 同步模式方法完全一致；
- 3、
connect超时设置同时作用于Connect、Recv和Send超时。
继承关系
- 1、Coroutine\Client 与 Client 不是继承关系，但
Client提供的方法均可在Coroutine\Client中使用。 - 2、在
Coroutine\Client中可以使用set方法设置配置选项，使用方法和与Client->set完全一致。
协议处理
协程客户端也支持长度和 EOF 协议处理，设置方法与 Swoole\Client 完全一致。
$client = new Swoole\Coroutine\Client(SWOOLE_SOCK_TCP);
$client->set(array(
'open_length_check' => true,
'package_length_type' => 'N',
'package_length_offset' => 0, //第N个字节是包长度的值
'package_body_offset' => 4, //第几个字节开始计算长度
'package_max_length' => 2000000, //协议最大长度
));
客户端案例
<?php
// 37-swoole-coroutine-client.php
Swoole\Coroutine\run(function () {
$client = new Swoole\Coroutine\Client(SWOOLE_SOCK_TCP);
if (!$client->connect('127.0.0.1', 9501, 0.5)) {
echo "connect failed. Error: {$client->errCode}\n";
}
$client->send("我是协程客户端\n");
echo $client->recv();
$client->close();
});
客户端 API
connect
含义：连接到远程服务器。
语法：Swoole\Coroutine\Client->connect(string $host, int $port, float $timeout = 0.5): bool
isConnected
含义：返回 Client 的连接状态。
语法：
Swoole\Coroutine\Client->isConnected(): bool
# 返回值
返回 false，表示当前未连接到服务器
返回 true，表示当前已连接到服务器
send
含义：发送数据。
语法：Swoole\Coroutine\Client->send(string $data): int|bool
参数：$data：为发送的数据，必须为字符串类型，支持二进制数据。
recv
含义：recv 方法用于从服务器端接收数据。
语法：Swoole\Coroutine\Client->recv(float $timeout = 0): string|bool
close
含义：关闭连接。
语法：Swoole\Coroutine\Client->close(): bool
peek
含义：窥视数据。
语法：Swoole\Coroutine\Client->peek(int $length = 65535): string
set
含义：设置客户端参数
语法：Swoole\Coroutine\Client->set(array $settings): bool
与 Swoole\Client 的差异：
协程客户端提供了更细粒度的超时控制。可以设置：
-
timeout：总超时，包括连接、发送、接收所有超时 -
connect_timeout：连接超时 -
read_timeout：接收超时 -
write_timeout：发送超时
我是温新，本篇文章结束。