# \_\_construct 方法
```php
void AsyncTcpConnection::__construct(string $remote_address, $context_option = null)
```
創建一個異步連接對象。
AsyncTcpConnection可以讓Workerman作為客戶端向遠程服務端發起異步連接,并通過send接口和onMessage回調異步發送和處理連接上的數據。
## 參數
參數:`remote_address`
連接的地址,例如
`tcp://www.baidu.com:80`
`ssl://www.baidu.com:443`
`ws://echo.websocket.org:80`
`frame://192.168.1.1:8080`
`text://192.168.1.1:8080`
參數:`$context_option`
```此參數要求(workerman >= 3.3.5)```
用來設置socket上下文,例如利用```bindto```設置以哪個(網卡)ip和端口訪問外部網絡,設置ssl證書等。
參考 [stream\_context\_create](http://php.net/manual/en/function.stream-context-create.php)、 [套接字上下文選項](http://php.net/manual/zh/context.socket.php)、[SSL 上下文選項](http://php.net/manual/zh/context.ssl.php)
## 注意
目前AsyncTcpConnection支持的協議有[tcp](http://baike.baidu.com/subview/32754/8048820.htm)、[ssl](http://baike.baidu.com/view/525499.htm)、[ws](315306)、[frame](315308)、[text](315307)。
同時支持自定義協議,參見[如何自定義協議](315125)
其中[ssl](http://baike.baidu.com/view/525499.htm)要求Workerman>=3.3.4,并安裝[openssl擴展](http://php.net/manual/zh/book.openssl.php)。
目前不支持[http](http://baike.baidu.com/view/9472.htm)協議的AsyncTcpConnection。
可以用```new AsyncTcpConnection('ws://...')```像瀏覽器一樣在workerman里發起websocket連接遠程websocket服務器,見[示例](315306)。但是不能以 ```new AsyncTcpConnection('websocket://...')```的形式在workerman里發起websocket連接。
## 示例
### 示例 1、異步訪問外部http服務
```php
use \Workerman\Worker;
use \Workerman\Connection\AsyncTcpConnection;
require_once __DIR__ . '/Workerman/Autoloader.php';
$task = new Worker();
// 進程啟動時異步建立一個到www.baidu.com連接對象,并發送數據獲取數據
$task->onWorkerStart = function($task)
{
// 不支持直接指定http,但是可以用tcp模擬http協議發送數據
$connection_to_baidu = new AsyncTcpConnection('tcp://www.baidu.com:80');
// 當連接建立成功時,發送http請求數據
$connection_to_baidu->onConnect = function($connection_to_baidu)
{
echo "connect success\n";
$connection_to_baidu->send("GET / HTTP/1.1\r\nHost: www.baidu.com\r\nConnection: keep-alive\r\n\r\n");
};
$connection_to_baidu->onMessage = function($connection_to_baidu, $http_buffer)
{
echo $http_buffer;
};
$connection_to_baidu->onClose = function($connection_to_baidu)
{
echo "connection closed\n";
};
$connection_to_baidu->onError = function($connection_to_baidu, $code, $msg)
{
echo "Error code:$code msg:$msg\n";
};
$connection_to_baidu->connect();
};
// 運行worker
Worker::runAll();
```
### 示例 2、異步訪問外部websocket服務,并設置以哪個本地ip及端口訪問
```php
<?php
use Workerman\Worker;
use Workerman\Connection\AsyncTcpConnection;
require_once __DIR__ . '/Workerman/Autoloader.php';
$worker = new Worker();
$worker->onWorkerStart = function($worker){
// 設置訪問對方主機的本地ip及端口(每個socket連接都會占用一個本地端口)
$context_option = array(
'socket' => array(
// ip必須是本機網卡ip,并且能訪問對方主機,否則無效
'bindto' => '114.215.84.87:2333',
),
);
$con = new AsyncTcpConnection('ws://echo.websocket.org:80', $context_option);
$con->onConnect = function($con) {
$con->send('hello');
};
$con->onMessage = function($con, $data) {
echo $data;
};
$con->connect();
};
Worker::runAll();
```
### 示例 3、異步訪問外部wss端口,并設置本地ssl證書
```php
<?php
use Workerman\Worker;
use Workerman\Connection\AsyncTcpConnection;
require_once __DIR__ . '/../Workerman/Autoloader.php';
$worker = new Worker();
$worker->onWorkerStart = function($worker){
// 設置訪問對方主機的本地ip及端口以及ssl證書
$context_option = array(
'socket' => array(
// ip必須是本機網卡ip,并且能訪問對方主機,否則無效
'bindto' => '114.215.84.87:2333',
),
// ssl選項,參考http://php.net/manual/zh/context.ssl.php
'ssl' => array(
// 本地證書路徑。 必須是 PEM 格式,并且包含本地的證書及私鑰。
'local_cert' => '/your/path/to/pemfile',
// local_cert 文件的密碼。
'passphrase' => 'your_pem_passphrase',
// 是否允許自簽名證書。
'allow_self_signed' => true,
// 是否需要驗證 SSL 證書。
'verify_peer' => false
)
);
// ssl需要訪問443端口
$con = new AsyncTcpConnection('ws://echo.websocket.org:443', $context_option);
// 設置以ssl加密方式訪問
$con->transport = 'ssl';
$con->onConnect = function($con) {
$con->send('hello');
};
$con->onMessage = function($con, $data) {
echo $data;
};
$con->connect();
};
Worker::runAll();
```
- 序言
- 原理
- 開發必讀
- 入門指引
- 特性
- 簡單的開發示例
- 安裝
- 環境要求
- 下載安裝
- 啟動停止
- 開發流程
- 開發前必讀
- 目錄結構
- 開發規范
- 基本流程
- 通訊協議
- 通訊協議作用
- 定制通訊協議
- 一些例子
- Worker類
- 構造函數
- 屬性
- id
- count
- name
- protocol
- transport
- reusePort
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回調屬性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- runAll
- stopAll
- listen
- TcpConnection類
- 屬性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- maxPackageSize
- 回調屬性
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- AsyncTcpConnection類
- 構造函數
- connect
- reconnect
- transport
- Timer定時器類
- add
- del
- 定時器注意事項
- WebServer
- 調試
- 基本調試
- 查看運行狀態
- 網絡抓包
- 跟蹤系統調用
- 常用組件
- GlobalData數據共享組件
- GlobalDataServer
- GlobalDataClient
- Channel分布式通訊組件
- ChannelServer
- channelClient
- 例子-集群推送
- 例子-分組發送
- FileMonitor文件監控組件
- MySQL組件
- workerman/mysql
- swoole/mysql(異步)
- redis組件
- swoole/redis
- 異步http組件
- swoole/http-client
- 異步消息隊列組件
- react/zmq
- react/stomp
- 異步dns組件
- swoole/dns
- 常見問題
- 心跳
- 客戶端鏈接失敗原因
- 是否支持多線程
- 與其它框架整合
- 運行多個workerman
- 支持哪些協議
- 如何設置進程數
- 查看客戶端連接數
- 對象和資源的持久化
- 例子無法工作
- 啟動失敗
- 停止失敗
- 支持多少并發
- 更改代碼不生效
- 向指定客戶端發送數據
- 如何主動推送消息
- 在其它項目中推送
- 如何實現異步任務
- status里send_fail的原因
- Windows下開發Linux下部署
- 是否支持socket.io
- 終端關閉導致workerman關閉
- 與nginx apache的關系
- 禁用函數檢查
- 平滑重啟原理
- 為Flash開843端口
- 如何廣播數據
- 如何建立udp服務
- 監聽ipv6
- 關閉未認證的鏈接
- 傳輸加密-ssl/tsl
- 創建wss服務
- 創建https服務
- workerman作為客戶端
- 作為ws/wss客戶端
- PHP的幾種回調寫法
- 附錄
- Linux內核調優
- 壓力測試
- 安裝擴展
- websocket協議
- ws協議
- text協議
- frame協議
- 不支持的函數/特性
- 版權信息