socket_create_listen

接続を受けつけるためにポートにソケットをオープンする

説明

Socketfalse socket_create_listen(int $port, int $backlog = 128)

socket_create_listen は、 AF_INET 型で すべての ローカルインターフェイスの指定したポート上で新規接続を待ち受ける 新しい Socket クラスのインスタンスを作成します。

この関数は、新規接続のみを受け入れるソケットを作成しやすくするためのものです。

パラメータ

port

すべてのインターフェイスで待ち受けるポート。

backlog

backlog パラメータは、 接続の順番待ちのキューをどれだけの長さまで保持するかを定義します。 SOMAXCONNbacklog パラメータに渡します。詳細な情報は socket_listen を参照ください。

戻り値

socket_create_listen は、 成功した場合に新しい Socket クラスのインスタンスを、 エラー時に false を返します。エラーコードは socket_last_error で取得可能です。このコードを socket_strerror に渡すと、エラーの詳細が文字列で取得可能です。

変更履歴

バージョン 説明
8.0.0 成功した場合に、この関数は Socket クラスのインスタンスを返すようになりました。 これより前のバージョンでは、リソースを返していました。

注意

注意:

特定のインターフェイスのみを listen するソケットを作成したい場合は socket_createsocket_bind および socket_listen を使用します。

参考

  • socket_create
  • socket_create_pair
  • socket_bind
  • socket_listen
  • socket_last_error
  • socket_strerror