mysqli::poll

mysqli_poll

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

mysqli::poll -- mysqli_poll — Poll connections

Descrizione

Stile orientato agli oggetti

public static function mysqli::poll(
    ?array &$read,
    ?array &$error,
    array &$reject,
    int $seconds,
    int $microseconds = 0
): int|false

Stile procedurale

function mysqli_poll(
    ?array &$read,
    ?array &$error,
    array &$reject,
    int $seconds,
    int $microseconds = 0
): int|false

Poll connections. The method can be used as static.

Nota:
Disponibile solo con mysqlnd.

Elenco dei parametri

read: List of connections to check for outstanding results that can be read.
error: List of connections on which an error occurred, for example, query failure or lost connection.
reject: List of connections rejected because no pending asynchronous query exists to poll.
seconds: Maximum number of seconds to wait, must be non-negative.
microseconds: Maximum number of microseconds to wait, must be non-negative.

Valori restituiti

Returns number of ready connections upon success, false otherwise.

Errori/Eccezioni

A ValueError is thrown when neither the read nor error arguments are passed.

Log delle modifiche

Versione	Descrizione
8.3.0	Now throws a ValueError exception when neither the `read` nor `error` arguments are passed.

Esempi

Example #1 A mysqli_poll() 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));
?>

Il precedente esempio visualizzerà:

Array
(
    [0] => test
)

Vedere anche:

mysqli_query() - Performs a query on the database
mysqli_reap_async_query() - Get result from async query