socket_create_listen
(PHP 4 >= 4.1.0, PHP 5)
socket_create_listen — 接続を受けつけるためにポートにソケットをオープンする
説明
resource socket_create_listen
( int $port
[, int $backlog = 128
] )
socket_create_listen() は、 AF_INET 型で すべての ローカルインターフェースの指定したポート上で新規接続を待ち受ける 新規ソケットリソースを作成します。
この関数は、新規接続のみを受け入れるソケットを作成しやすくするためのものです。
パラメータ
- port
-
すべてのインターフェイスで待ち受けるポート。
- backlog
-
backlog パラメータは、 接続の順番待ちのキューをどれだけの長さまで保持するかを定義します。 SOMAXCONN を backlog パラメータに渡します。詳細な情報は socket_listen() を参照ください。
返り値
socket_create_listen() は、 成功した場合に新規ソケットリソースを、エラー時に FALSE を返します。エラーコードは socket_last_error() で取得可能です。このコードを socket_strerror() に渡すと、エラーの詳細が文字列で取得可能です。
注意
注意:
特定のインターフェースのみを listen するソケットを作成したい場合は socket_create()、 socket_bind() および socket_listen() を使用します。
参考
- socket_create() - ソケット（通信時の終端）を作成する
- socket_create_pair() - 区別できないソケットの組を作成し、配列に保存する
- socket_bind() - ソケットに名前をバインドする
- socket_listen() - ソケット上で接続待ち(listen)する
- socket_last_error() - ソケットの直近のエラーを返す
- socket_strerror() - ソケットエラーの内容を文字列として返す
