socket_create_listen
(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_create_listen — 接続を受けつけるためにポートにソケットをオープンする
説明
socket_create_listen
( int $port
[, int $backlog
= 128
] ) : resource
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() - ソケットエラーの内容を文字列として返す