Server->addListener · Swoole文檔手冊

# Server->addListener [TOC] 增加監聽的端口。業務代碼中可以通過調用[Server->getClientInfo](Server-getClientInfo.md)來獲取某個連接來自于哪個端口。函數原型： ~~~ function Server->addListener(string $host, int $port, $type = SWOOLE_SOCK_TCP); ~~~ * 監聽`1024`以下的端口需要`root`權限 * 主服務器是`WebSocket`或`Http`協議，新監聽的`TCP`端口默認會繼承主`Server`的協議設置。必須單獨調用set方法設置新的協議才會啟用新協議[查看詳細說明](監聽端口.md "連接") ## 返回值 * 監聽端口失敗，返回`false`，可調用`getLastError`方法獲取錯誤碼 * 監聽成功后會返回`Swoole\Server\Port`對象，在此對象上可以為此端口單獨設置事件回調函數和運行參數 ## 支持的 Socket 類型 * **SWOOLE\_TCP**/**SWOOLE\_SOCK\_TCP**tcp ipv4 socket * **SWOOLE\_TCP6**/**SWOOLE\_SOCK\_TCP6**tcp ipv6 socket * **SWOOLE\_UDP**/**SWOOLE\_SOCK\_UDP**udp ipv4 socket * **SWOOLE\_UDP6**/**SWOOLE\_SOCK\_UDP6**udp ipv6 socket * **SWOOLE\_UNIX\_DGRAM**unix socket dgram * **SWOOLE\_UNIX\_STREAM**unix socket stream > `Unix Socket`模式下`$host`參數必須填寫可訪問的文件路徑，`$port`參數忽略 > `Unix Socket`模式下，客戶端`$fd`將不再是數字，而是一個文件路徑的字符串 > `SWOOLE_TCP`等是`1.7.0`后提供的簡寫方式，與`SWOOLE_SOCK_TCP`是等同的您可以混合使用`UDP/TCP`，同時監聽內網和外網端口。示例： ~~~ $serv->addlistener("127.0.0.1", 9502, SWOOLE_SOCK_TCP); $serv->addlistener("192.168.1.100", 9503, SWOOLE_SOCK_TCP); $serv->addlistener("0.0.0.0", 9504, SWOOLE_SOCK_UDP); //UnixSocket Stream $serv->addlistener("/var/run/myserv.sock", 0, SWOOLE_UNIX_STREAM); //TCP + SSL $serv->addlistener("127.0.0.1", 9502, SWOOLE_SOCK_TCP | SWOOLE_SSL); ~~~ ## IPv4與IPv6 * IPv4使用 127.0.0.1表示監聽本機，0.0.0.0表示監聽所有地址 * IPv6使用::1表示監聽本機，:: (0:0:0:0:0:0:0:0) 表示監聽所有地址 * **Linux系統下監聽IPv6端口后使用IPv4地址也可以進行連接** ## 隨機監聽端口 `1.9.6`增加了隨機監聽端口的特性，`$port`參數可以設置為0，操作系統會隨機分配一個可用的端口進行監聽。可以讀取`$listen_port->port`獲取分配到的端口號。 ~~~ $port = $serv->addListener("0.0.0.0", 0, SWOOLE_SOCK_TCP); echo $port->port; ~~~