socket_getsockname

(PHP 4 >= 4.1.0, PHP 5)

socket_getsockname -- Interroge la socket locale

Description

bool socket_getsockname ( resource socket, string &addr [, int &port] )

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.

Si la 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 la 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.

Note : socket_getsockname() ne doit pas être utilisée avec les sockets AF_UNIX créées avec socket_connect(). Seules les sockets suivant un appel de socket_bind() retourneront des valeurs logiques.

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec. socket_getsockname() peut aussi retourner FALSE si le type de la 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(), socket_last_error() et socket_strerror().