pg_socket_poll

(PHP 8 >= 8.4.0)

pg_socket_poll — Poll a PostgreSQL connection socket for read/write readiness

Description

function pg_socket_poll(
    resource $socket,
    int $read,
    int $write,
    int $timeout = -1
): int

Polls a PostgreSQL connection socket for read and/or write readiness. The socket can be obtained using pg_socket(). This function is useful for implementing non-blocking, asynchronous query workflows.

Parameters

socket: A socket resource obtained from pg_socket().
read: Whether to check for read readiness. Pass 1 to check, 0 to skip.
write: Whether to check for write readiness. Pass 1 to check, 0 to skip.
timeout: The maximum number of milliseconds to wait. Pass -1 to wait indefinitely, or 0 to not wait at all.

Return Values

Returns a positive value if the socket is ready, 0 if the timeout was reached, or -1 on error.

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.