# 配置選項 [TOC] `Client`可以使用`set`方法設置一些選項，啟用某些特性。 ## 作用范圍 * `Swoole\Client` * `Swoole\Http\Client` * `Swoole\Coroutine\Client` * `Swoole\Coroutine\Http\Client` * `Swoole\Coroutine\Http2\Client` ## 結束符檢測 ~~~ $client->set(array( 'open_eof_check' => true, 'package_eof' => "\r\n\r\n", 'package_max_length' => 1024 * 1024 * 2, )) ~~~ ## 長度檢測 ~~~ $client->set(array( 'open_length_check' => 1, 'package_length_type' => 'N', 'package_length_offset' => 0, //第N個字節是包長度的值 'package_body_offset' => 4, //第幾個字節開始計算長度 'package_max_length' => 2000000, //協議最大長度 )); ~~~ ## MQTT協議 啟用`MQTT`協議解析，`onReceive`回調將收到完整的`MQTT`數據包。 ~~~ $client->set(array( 'open_mqtt_protocol' => true, )); ~~~ ## Socket緩存區尺寸 ~~~ $client->set(array( 'socket_buffer_size' => 1024*1024*2, //2M緩存區 )); ~~~ > 包括`socket`底層操作系統緩存區、應用層接收數據內存緩存區、應用層發送數據內存緩沖區 ## 關閉Nagle合并算法 ~~~ $client->set(array( 'open_tcp_nodelay' => true, )); ~~~ ## SSL/TLS證書 ~~~ $client->set(array( 'ssl_cert_file' => $your_ssl_cert_file_path, 'ssl_key_file' => $your_ssl_key_file_path, )); ~~~ > swoole-1.7.21或更高版本可用 ## 綁定IP和端口 > 僅設置`bind_port`是無效的，請同時設置`bind_port`和`bind_address` * 機器有多個網卡的情況下，設置`bind_address`參數可以強制客戶端`Socket`綁定某個網絡地址。 * 設置`bind_port`可以使客戶端Socket使用固定的端口連接到外網服務器 ~~~ $client->set(array( 'bind_address' => '192.168.1.100', 'bind_port' => 36002, )); ~~~ ## Socks5代理設置 > 僅設置一個選項是無效的, 每次必須設置`host`和`port` ~~~ $client->set(array( 'socks5_host' => '192.168.1.100', 'socks5_port' => 1080, 'socks5_username' => 'username', 'socks5_password' => 'password', )); ~~~ * `socks5_username`、`socks5_password`為可選參數 ## 使用說明 * 目前支持open\_length\_check和open\_eof\_check2種自動協議處理功能，參考swoole\_server中的配置選項 * 啟用了自動協議后，同步阻塞客戶端recv方法將不接受長度參數，每次必然返回一個完整的數據包 * 啟用了自動協議后，異步非阻塞客戶端onReceive每次必然返回一個完整的數據包