pg_socket_poll
(PHP 8 >= 8.4.0)
Poll a PostgreSQL connection socket for read/write readiness
Description
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
socketA socket resource obtained from
pg_socket().readWhether to check for read readiness. Pass
1to check,0to skip.writeWhether to check for write readiness. Pass
1to check,0to skip.timeoutThe maximum number of milliseconds to wait. Pass
-1to wait indefinitely, or0to 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.