socket_get_option

(PHP 4 >= 4.3.0, PHP 5)

socket_get_option -- Lit les options de la socket

Description

mixed socket_get_option ( resource socket, int level, int optname )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

socket_get_option() retourne la valeur de l'option spécifié par le paramètre optname pour la socket spécifiée par le paramètre socket. socket_get_option() retourne FALSE en cas d'erreur.

Le paramètre level spécifie la couche de protocole de l'option. Par exemple, pour connaître les options de la couche socket, la valeur SOL_SOCKET du paramètre level sera utilisée. Les autres degrés, comme TCP, peuvent être utilisés en spécifiant le numéro du protocole de cette couche. Les numéros de protocoles peuvent être trouvés en utilisant la fonction getprotobyname().

Tableau 1. Options disponibles pour les sockets

OptionDescription
SO_DEBUG Reporte si les informations de débogage sont enregistrées ou pas.
SO_ACCEPTCONN Reporte si l'écoute des sockets est activée ou pas.
SO_BROADCAST Reporte si la transmission des annonces globales est supportée ou pas.
SO_REUSEADDR Reporte si les adresses locales peuvent être réutilisées ou pas.
SO_KEEPALIVE Reporte si les connexions sont persistantes avec des transmissions périodiques de messages ou pas. Si la socket connectée échoue en réponse à ces messages, la connexion est interrompue et le processus écrira à cette socket une notification avec un signal SIGPIPE.
SO_LINGER Reporte si la socket socket s'attarde sur la fonction socket_close() si des données sont présentes ou pas.
SO_OOBINLINE Reporte si la socket socket part sur des données en ligne out-of-band ou pas.
SO_SNDBUF Reporte les informations sur la taille du tampon envoyé.
SO_RCVBUF Reporte les informations sur la taille du tampon reçu.
SO_ERROR Reporte les informations sur le statut de l'erreur et le vide.
SO_TYPE Reporte le type de la socket socket.
SO_DONTROUTE Reporte si les messages sortants dévient les équipements standard de cheminement.
SO_RCVLOWAT Reporte le nombre minimal d'octets au processus pour les opérations entrantes sur la socket socket. (Par défaut, 1)
SO_RCVTIMEO Reporte la valeur du délai d'exécution pour les opérations entrantes.
SO_SNDLOWAT Reporte le nombre minimal d'octets au processus pour les opérations sortantes sur la socket socket.
SO_SNDTIMEO Reporte la valeur du délai d'exécution spécifiant le temps maximal d'exécution pour les fonctions sortantes bloquantes parce que la commande d'écoulement empêche des données d'être envoyé.

Note : Cette fonction était appelée socket_getopt() avant PHP 4.3.0.