MYSQLI_POLL(3) 1 MYSQLI_POLL(3)
mysqli::poll - Poll connections
Object oriented style
SYNOPSIS
publicstatic int mysqli::poll (array &$read, array &$error, array &$reject, int $sec, [int $usec])
DESCRIPTION
Procedural style
int mysqli_poll (array &$read, array &$error, array &$reject, int $sec, [int $usec])
Poll connections. Available only with mysqlnd. The method can be used as static.
PARAMETERS
o $read
- List of connections to check for outstanding results that can be read.
o $error
- List of connections on which an error occured, for example, query failure or lost connection.
o $reject
- List of connections rejected because no asynchronous query has been run on for which the function could poll results.
o $sec
- Number of seconds to wait, must be non-negative.
o $usec
- Number of microseconds to wait, must be non-negative.
RETURN VALUES
Returns number of ready connections upon success, FALSE otherwise.
EXAMPLES
Example #1
A mysqli_poll(3) example
<?php
$link1 = mysqli_connect();
$link1->query("SELECT 'test'", MYSQLI_ASYNC);
$all_links = array($link1);
$processed = 0;
do {
$links = $errors = $reject = array();
foreach ($all_links as $link) {
$links[] = $errors[] = $reject[] = $link;
}
if (!mysqli_poll($links, $errors, $reject, 1)) {
continue;
}
foreach ($links as $link) {
if ($result = $link->reap_async_query()) {
print_r($result->fetch_row());
if (is_object($result))
mysqli_free_result($result);
} else die(sprintf("MySQLi Error: %s", mysqli_error($link)));
$processed++;
}
} while ($processed < count($all_links));
?>
The above example will output:
Array
(
[0] => test
)
SEE ALSO
mysqli_query(3), mysqli_reap_async_query(3).
PHP Documentation Group MYSQLI_POLL(3)
