socket_getsockname
(PHP 4 >= 4.1.0, PHP 5)
socket_getsockname — Interroge le socket local
Description
$socket
, string &$addr
[, int &$port
] )Note: socket_getsockname() ne doit pas être utilisée avec les sockets
AF_UNIX
créés avec socket_connect(). Seules les sockets suivant un appel de socket_bind() retourneront des valeurs logiques.
Liste de paramètres
-
socket
-
Une ressource de socket valide, créée par la fonction socket_create() ou la fonction socket_accept().
-
addr
-
Si le socket
socket
est de typeAF_INET
, ouAF_INET6
, socket_getsockname() retournera l'adresse IP locale, en notation numérique (e.g. 127.0.0.1 ou fe80::1) dans le paramètreaddress
, et si le paramètre optionnelport
est présent, elle retournera aussi le port de la communication établie.Si le socket
socket
est de typeAF_UNIX
, socket_getsockname() retournera le chemin sur le système de fichiers (e.g. /var/run/daemon.sock) dans le paramètreaddress
. -
port
-
Si fourni, ce devra être le port associé à l'adresse.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient. socket_getsockname() peut aussi
retourner FALSE
si le type du socket n'est ni AF_INET
,
ni AF_INET
, ni AF_UNIX
, auquel cas
le dernier code d'erreur socket n'est pas modifié.
Voir aussi
- socket_getpeername() - Interroge l'autre extrémité de la communication
- 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