Poll a PostgreSQL connection socket for read/write readiness

Descripción

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.

Parámetros

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.

Valores devueltos

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

Ver también

pg_socket() - Obtiene un manejador de solo lectura sobre el socket subyacente de una conexión PostgreSQL
pg_consume_input() - Lee la entrada de la conexión
pg_send_query() - Ejecuta una consulta PostgreSQL asíncrona