Poll a PostgreSQL connection socket for read/write readiness

説明

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.

パラメータ

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.

戻り値

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

参考

pg_socket() - PostgreSQL 接続の下層にある、読み取り専用のソケットのハンドルを取得する
pg_consume_input() - 接続の入力を読み取る
pg_send_query() - 非同期クエリを送信する