downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | my php.net 
search for in the  

<socket_listensocket_recv>
Last updated: Thu, 26 Jun 2008

socket_read

(PHP 4 >= 4.0.7, PHP 5)

socket_read — Reads a maximum of length bytes from a socket

Description

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

The function socket_read() reads from the socket resource socket created by the socket_create() or socket_accept() functions.

Parameters

socket

A valid socket resource created with socket_create() or socket_accept().

length

The maximum number of bytes read is specified by the length parameter. Otherwise you can use \r, \n, or \0 to end reading (depending on the type parameter, see below).

type

Optional type parameter is a named constant:

  • PHP_BINARY_READ (Default) - use the system recv() function. Safe for reading binary data.
  • PHP_NORMAL_READ - reading stops at \n or \r.

Return Values

socket_read() returns the data as a string on success, or FALSE on error (including if the remote host has closed the connection). The error code can be retrieved with socket_last_error(). This code may be passed to socket_strerror() to get a textual representation of the error.

Note: socket_read() returns a zero length string ("") when there is no more data to read.

ChangeLog

Version Description
4.1.0 The default value for type was changed from PHP_NORMAL_READ to PHP_BINARY_READ



add a noteadd a note User Contributed Notes
Reads a maximum of length bytes from a socket
There are no user contributed notes for this page.




<socket_listensocket_recv>
Last updated: Thu, 26 Jun 2008
show source | credits | sitemap | contact | advertising | mirror sites
Copyright © 2001-2005 The PHP Group
All rights reserved.
This unofficial mirror is operated at: http://phpbuilder.com/
Last updated: Tue Nov 1 20:20:59 2005 EST
Columns / Articles | Tips / Quickies | News | News Linking and RSS Feeds | Shared Code Library
Mail Archives | Support / Discussion Forums | Get Started! Links | Contribute! | Docs