# Coroutine\\Socket->listen [TOC] 監聽`Socket`。 ~~~ function Coroutine\Socket->listen(int $backlog = 0) : bool; ~~~ * 此方法沒有`IO`操作，不會引起協程切換 ## 參數 * `$backlog`：監聽隊列的長度，默認為`0`，系統底層使用`epoll`實現了異步`IO`，不存在阻塞，因此`backlog`的重要程度并不高 > 注意：如果應用中存在阻塞或耗時邏輯，`accept`接受連接不及時，新創建的連接就會堆積在`backlog`監聽隊列中，如超出`backlog`長度，服務就會拒絕新的連接進入 ## 內核參數 `backlog`的最大值受限于內核參數`net.core.somaxconn`, 而Linux中可以工具`sysctl`來動態調整所有的kernel參數。所謂動態調整就是內核參數值修改后即時生效。但是這個生效僅限于`OS`層面，必須重啟應用才能真正生效, 命令`sysctl -a`會顯示所有的內核參數及值。 ~~~ sysctl -w net.core.somaxconn=2048 ~~~ 以上命令將內核參數`net.core.somaxconn`的值改成了`2048`。這樣的改動雖然可以立即生效，但是重啟機器后會恢復默認值。為了永久保留改動，需要修改`/etc/sysctl.conf`，增加`net.core.somaxconn=2048`然后執行命令`sysctl -p`生效。 ## 返回值 * 監聽成功返回`true` * 監聽失敗返回`false`，請檢查`errCode`屬性獲取失敗原因