Запрашивает локальную сторону указанного сокета, в результате можно получить хост/порт или путь в файловой системе Unix, в зависимости от типа сокета

# socket_getsockname

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

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

### Описание

function 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.5.0 | Теперь получает индекс интерфейса и его строковое представление при использовании на сокете семейства `AF_PACKET`.
8.0.0 | Параметр `socket` теперь принимает объект Socket; раньше принимался тип resource.

### Смотрите также

- socket_getpeername() - Опрашивает удалённую сторону сокета
- socket_last_error() - Возвращает последнюю ошибку сокета
- socket_strerror() - Возвращает строку, описывающую ошибку сокета

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open