# Client [TOC] `Client`提供了`TCP/UDP``socket`的客戶端的封裝代碼，使用時僅需`new Swoole\Client`即可。 ## 優勢 * `stream`函數存在超時設置的陷阱和`Bug`，一旦沒處理好會導致`Server`端長時間阻塞 * `stream`函數的`fread`默認最大`8192`長度限制，無法支持`UDP`的大包 * `Client`支持`waitall`，在有確定包長度時可一次取完，不必循環讀取 * `Client`支持`UDP connect`，解決了`UDP`串包問題 * `Client`是純`C`的代碼，專門處理`socket`，`stream`函數非常復雜。`Client`性能更好 * `Client`支持長連接 除了普通的同步阻塞+`select`的使用方法外，`Client`還支持異步非阻塞回調。 ## 同步阻塞客戶端 ~~~ $client = new swoole_client(SWOOLE_SOCK_TCP); if (!$client->connect('127.0.0.1', 9501, -1)) { exit("connect failed. Error: {$client->errCode}\n"); } $client->send("hello world\n"); echo $client->recv(); $client->close(); ~~~ > `php-fpm/apache`環境下只能使用同步客戶端 > `apache`環境下僅支持`prefork`多進程模式，不支持`prework`多線程 ## 異步非阻塞客戶端 ~~~ $client = new Swoole\Client(SWOOLE_SOCK_TCP, SWOOLE_SOCK_ASYNC); $client->on("connect", function(swoole_client $cli) { $cli->send("GET / HTTP/1.1\r\n\r\n"); }); $client->on("receive", function(swoole_client $cli, $data){ echo "Receive: $data"; $cli->send(str_repeat('A', 100)."\n"); sleep(1); }); $client->on("error", function(swoole_client $cli){ echo "error\n"; }); $client->on("close", function(swoole_client $cli){ echo "Connection close\n"; }); $client->connect('127.0.0.1', 9501); ~~~ > 異步客戶端只能使用在`cli`命令行環境