無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

socket_read

(PHP 4 >= 4.0.7, PHP 5)

socket_readソケットから最大バイト長まで読みこむ

説明

string socket_read ( resource $socket , int $length [, int $type ] )

関数 socket_read() は、関数 socket_create() または socket_accept() により作成されたソケット リソース socket から読み込みます。

パラメータ

socket

socket_create() あるいは socket_accept() で作成したソケットリソース。

length

読み込まれる最大バイト長は、length パラメータで 指定します。 読み込みを終了するために \r、\n、\0 を使用することが可能です (これは、以下に示す type に依存します)。

type

オプションのパラメータ type は、名前のある定数です。

  • PHP_BINARY_READ (デフォルト) - システムの recv() 関数を 使用します。バイナリデータ読み込みに関して安全です。
  • PHP_NORMAL_READ - 読み込みは、\n あるいは \r で中断されます。

返り値

socket_read() は、成功時に文字列としてデータを返し、 エラー時 (リモートホストが接続をクローズした場合を含みます) に FALSE を返します。 エラーコードは socket_last_error() で取得可能であり、 このコードは、エラー文字列を取得するために socket_strerror() に渡すことができます。

注意: socket_read() は、読み込むデータがもう存在しない 場合に長さゼロの文字列("")を返します。

変更履歴

バージョン 説明
4.1.0 type のデフォルト値が PHP_NORMAL_READ から PHP_BINARY_READ に変わりました。