Mid-Atlantic Developer Conference - Call for Speakers


(PHP 4 >= 4.1.0, PHP 5, PHP 7)

socket_getsocknameInterroge le socket local


bool socket_getsockname ( resource $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


Une ressource de socket valide, créée par la fonction socket_create() ou la fonction socket_accept().


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


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

add a note add a note

User Contributed Notes 2 notes

3 years ago
Curiously, getsockname() works for socket_create() and socket_create_pair() Unix-domain (AF_UNIX) sockets if one calls socket_bind() after creation to name the formerly anonymous socket(s). 

Using a socket_bind() call also results in a file system "file" (socket, first character 's' in an "ls -l" listing) being created with the given name.  Such a "file" will need to be removed explicitly, as closing the socket will not remove it.
not at valid dot com
10 years ago
Just a quick note:
I found socket_getsockname() is not IPv6 compatible or may just return some unexpected results?

Simple Code Example

$socket = socket_create(AF_INET,SOCK_STREAM,SOL_TCP);

socket_getsockname($socket, $IP, $PORT);



This does not print $IP or or even ... etc ... like you would expect ... in my case I receive witch is not a valid port on my system using IPv5 and IPv6! Thus you should rely on using the initial values of socket_bind() to get the local address.

Hope this helps...
To Top