socket_read
(PHP 4 >= 4.1.0, PHP 5)
socket_read — Lit des données d'un socket
Description
$socket
, int $length
[, int $type
= PHP_BINARY_READ
] )
socket_read() lit des données dans le socket
socket
, qui doit être une ressource créée par
la fonction socket_create() ou la fonction
socket_accept().
Liste de paramètres
-
socket
-
Une ressource de socket valide, créée par la fonction socket_create() ou la fonction socket_accept().
-
length
-
Elle lit un maximum de
length
octets. Sinon, vous pouvez utiliser\r
,\n
ou\0
pour terminer la lecture (suivant la valeur choisie pourtype
, voir ci-dessous). -
type
-
Le paramètre optionnel
type
peut prendre l'une des valeurs constantes suivantes :-
PHP_BINARY_READ
(Défaut) - utilise la fonction système recv(). Capable de lire les données binaires. -
PHP_NORMAL_READ
- la lecture s'arrête aux \n et \r
-
Valeurs de retour
socket_read() retourne les données sous forme de
chaîne en cas de succès, et FALSE
sinon (y compris si l'hôte distant
a fermé la connexion). Le code
d'erreur généré peut être obtenu en appelant la fonction
socket_last_error(). Ce code d'erreur
peut être passé à la fonction socket_strerror()
pour obtenir un message d'erreur humainement lisible.
Note:
socket_read() retourne une chaîne de longueur zéro (""), lorsqu'il n'y a plus de données à lire.
Historique
Version | Description |
---|---|
4.1.0 |
La valeur par défaut du paramètre type
est passée de PHP_NORMAL_READ à
PHP_BINARY_READ
|
Voir aussi
- socket_accept() - Accepte une connexion sur un socket
- socket_bind() - Lie un nom à un socket
- socket_connect() - Crée une connexion sur un socket
- socket_listen() - Attend une connexion sur un socket
- socket_last_error() - Lit la dernière erreur générée par un socket
- socket_strerror() - Retourne une chaîne décrivant un message d'erreur
- socket_write() - Écrit dans un socket