socket_getpeername
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_getpeername — Запитує віддалену сторону зазначеного сокету, в результаті може бути повернутий хост/порт або шлях у файловій системі Unix, залежно від типу сокету
Опис
socket_getpeername(Socket $socket, string &$address, int &$port = null): bool
Запитує віддалену сторону зазначеного сокету, в результаті може бути повернутий хост/порт або шлях у файловій системі Unix, залежно від типу сокету.
Список параметрів
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
Якщо зазначено, то міститиме порт, пов'язаний з адресою address
Значення, що повертаються
Повертає true у разі успішного виконання або falseв случае возникновения ошибкиsocket_getpeername() також може повернути **false**якщо сокет мати тип відмінний від AF_INET AF_INET6 або AF_UNIX, у цьому випадку код останньої помилки сокету НЕ буде оновлено.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | socket тепер екземпляр класу Socket; раніше був ресурсом (resource). |
Примітки
Зауваження :
socket_getpeername() не повинна бути використана із сокетами
AF_UNIX, створеними за допомогою функції socket_accept(). Тільки сокети, створені за допомогою socket_connect() або серверний сокет, до якого застосовано виклик функції socket_bind(), повертатимуть осмислені значення.
Зауваження :
Для того щоб socket_getpeername() повернула осмислене значення, сокет, якого вона застосовується, повинен розуміти концепцію " рівних відносин " (peer).
Дивіться також
- socket_getsockname() - Запитує локальну сторону зазначеного сокету, в результаті можна отримати хост/порт або шлях у файловій системі Unix, залежно від типу сокету
- socket_last_error() - Повертає останню помилку на сокеті
- socket_strerror() - Повертає рядок, що описує помилку сокету