(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_getsockname — Interroge le socket local
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.
socket
Une instance de Socket créée par socket_create() ou socket_accept().
address
Si le socket socket
est de type AF_INET
,
ou AF_INET6
, socket_getsockname() retournera
l'adresse IP locale, en notation numérique (e.g.
127.0.0.1
ou fe80::1
) dans le paramètre
address
, et si le paramètre optionnel
port
est présent, elle retournera aussi le port de la
communication établie.
Si le socket socket
est de type AF_UNIX
,
socket_getsockname() retournera le chemin sur le
système de fichiers (e.g. /var/run/daemon.sock
) dans le
paramètre address
.
port
Si fourni, ce devra être le port associé à l'adresse.
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é.
Version | Description |
---|---|
8.0.0 |
socket est désormais une instance de Socket ;
auparavant, c'était une resource.
|