stream_socket_recvfrom

(PHP 5, PHP 7, PHP 8)

stream_socket_recvfrom — 接続されているかどうかにかかわらず、ソケットからのデータを受信する

説明

stream_socket_recvfrom() は、 リモートソケットから最大 length バイトのデータを 受け取ります。

パラメータ

socket

リモートソケット。

length

socket から受信するバイト数。

flags

flags は以下の値の組み合わせです。 flags でとりうる値

STREAM_OOB OOB (out-of-band) データを処理します。

STREAM_PEEK ソケットからデータを取得しますが、バッファを消費しません。 fread() あるいは stream_socket_recvfrom() を続けてコールした 際には、同じデータが読み込まれます。

address

address が指定された場合、 そこにはリモートソケットのアドレスが保存されます。

戻り値

読み込んだデータを文字列で返します。 失敗した場合に false を返します

例

注意

注意:

受信したメッセージが length パラメータより 長かった場合、ソケットの型によっては(例えば UDP など)超過分の バイトデータが捨てられてしまう可能性があります。

注意:

バッファベースのストリーム関数 (fread() あるいは stream_get_line() など) をコールした後に ソケットベースのストリームで stream_socket_recvfrom() をコールすると、ストリームバッファを経由せず、データをソケットから 直接読み込みます。

参考

• stream_socket_sendto() - 接続されているかどうかにかかわらず、ソケットにデータを送信する
• stream_socket_client() - インターネットドメインまたは Unix ドメインのソケット接続を開く
• stream_socket_server() - インターネットドメインまたは Unix ドメインのサーバーソケットを作成する