array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.socket-create-listen.php', 1 => 'socket_create_listen', 2 => '接続を受けつけるためにポートにソケットをオープンする', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'ソケット 関数', ), 'prev' => array ( 0 => 'function.socket-create.php', 1 => 'socket_create', ), 'next' => array ( 0 => 'function.socket-create-pair.php', 1 => 'socket_create_pair', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/sockets/functions/socket-create-listen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_create_listen

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

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

説明

socket_create_listen(int $port, int $backlog = SOMAXCONN): Socket|false

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

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

パラメータ

port

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

backlog

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

戻り値

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

変更履歴

バージョン 説明
8.4.0 デフォルトの値は SOMAXCONN に設定されています。 以前のバージョンでは 128 でした。
8.0.0 成功した場合に、この関数は Socket クラスのインスタンスを返すようになりました。 これより前のバージョンでは、リソースを返していました。

注意

注意:

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

参考