« socket\_getpeernamesocket\_import\_stream »PHP ManualОпції сокету

socket_getsockname

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

socket_getsockname — Запитує локальну сторону вказаного сокету, в результаті можна отримати хост/порт або шлях у файловій системі Unix, залежно від типу сокету

Опис

socket_getsockname(Socket $socket, string &$address, int &$port = null): bool

Зауваження: Функцияsocket_getsockname() не повинна використовуватися із сокетами AF_UNIX, створеними за допомогою функції socket_connect(). Тільки сокети, створені функцією socket_accept() та первинні серверні сокети після виклику socket_bind(), дозволяють отримати осмислену відповідь під час виклику цієї функції.

Список параметрів

socket

Екземпляр Socket, створений функцією socket_create() або socket_accept()

address

Якщо заданий сокет має тип AF_INET або AF_INET6 socket_getpeername() поверне локальний IP-адреса у відповідному форматі (наприклад, 127.0.0.1илиfe80::1) в параметреaddress і якщо необов'язковий параметр port є також пов'язаний порт.

Якщо заданий сокет має тип AF_UNIX socket_getpeername() поверне шлях у файловій системі Unix (тобто . /var/run/daemon.sock) в параметрaddress

port

Якщо зазначено, то міститиме відповідний порт.

Значення, що повертаються

Повертає true у разі успішного виконання або falseв случае возникновения ошибкиsocket_getsockname() може також повертати false, якщо тип сокету не є одним з AF_INET AF_INET6, или**AF_UNIX**, у цьому випадку код останньої помилки сокету не оновлюється.

список змін

ВерсияОпис
8.0.0socket тепер екземпляр класу Socket; раніше був ресурсом (resource).

Дивіться також

  • socket_getpeername() - Запитує віддалену сторону зазначеного сокету, в результаті може бути повернутий хост/порт або шлях у файловій системі Unix, залежно від типу сокету
  • socket_last_error() - Повертає останню помилку на сокеті
  • socket_strerror() - Повертає рядок, що описує помилку сокету