Overview
KB
Technical FAQ
PHP Manual
CSS2 Manual
HTML Manual
JS Guide
JS Reference
PhpDock Manual
Nu-Coder Manual
PhpExpress Manual
PHP Joomla
Development
Learn PHP
 
<Socket Functionssocket_addrinfo_bind>
^Socket FunctionsLast updated: Mon, 26 Oct 2026

socket_accept

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

socket_accept — Accepts a connection on a socket

Description

function socket_accept(Socket $socket): Socket|false

After the socket socket has been created using socket_create(), bound to a name with socket_bind(), and told to listen for connections with socket_listen(), this function will accept incoming connections on that socket. Once a successful connection is made, a new Socket instance is returned, which may be used for communication. If there are multiple connections queued on the socket, the first will be used. If there are no pending connections, socket_accept() will block until a connection becomes present. If socket has been made non-blocking using socket_set_nonblock() and there are no pending connections, false will be returned without raising a warning.

The Socket instance returned by socket_accept() may not be used to accept new connections. The original listening socket socket, however, remains open and may be reused.

Parameters

socket

A Socket instance created with socket_create().

Return Values

Returns a new Socket instance on success, or false on error. The actual error code can be retrieved by calling socket_last_error() without an argument, as the error is not stored on socket. This error code may be passed to socket_strerror() to get a textual explanation of the error.

Changelog

Version Description
8.0.0 On success, this function returns a Socket instance now; previously, a resource was returned.

See Also


<Socket Functionssocket_addrinfo_bind>
^Socket FunctionsLast updated: Mon, 26 Oct 2026