Учебник РНР
Назад Вперёд

socket_create

(PHP 4 >= 4.1.0)

socket_create - создаёт сокет (конечную точку соединения).

Описание

resource socket_create (int domain, int type, int protocol)

Предупреждение!

Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

Создаёт конечную точку соединения (сокет) и возвращает ресурс сокета.

Параметр domain устанавливает домен (семейство протокола) для использования в соединении. В настоящее время понимаются AF_INET и AF_UNIX . AF_INET обычно используется для соединений на основе internet. AF_UNIX использует pathnames для идентификации сокетов и, следовательно, применим только для локальных соединений (что, с другой стороны, быстрее).

Параметр type выбирает тип сокета. Это один из: SOCK_STREAM , SOCK_DGRAM , SOCK_SEQPACKET , SOCK_RAW , SOCK_RDM , SOCK_PACKET . Два самых распространённых - SOCK_DGRAM для UDP (connectionless) взаимодействия и SOCK_STREAM для TCP-взаимодействия.

protocol устанавливает протокол: SOL_UDP или SOL_TCP .

Возвращает ресурс сокета при успехе, FALSE при ошибке. Код ошибки можно запросить функцией socket_last_error() . Этот код ошибки можно передавать в socket_strerror() для получения текстового объяснения ошибки.

Дополнительно об использовании socket_create(), а также о значениях различных параметров, см. Unix man-страницу socket (2).

Примечание: если задан неверный domain или type , socket_create() по умолчанию имеет AF_INET и SOCK_STREAM соответственно и дополнительно выдаёт сообщение E_WARNING .

См. также socket_accept() , socket_bind() , socket_connect() , socket_listen() , socket_last_error() и socket_strerror() .


Назад Оглавление Вперёд
socket_create_pair Вверх socket_get_option