mysqli::ping

    mysqli_ping

    (PHP 5, PHP 7, PHP 8)

    mysqli::ping -- mysqli_ping — Pingt eine Serververbindung an oder versucht eine neue Verbindung aufzubauen, wenn die Verbindung unterbrochen wurde

    Beschreibung

    Objektorientierter Stil

    publicmysqli::ping(): bool

    Prozeduraler Stil

    mysqli_ping(mysqli$mysql): bool

    Überprüft, ob die Verbindung zum Server funktioniert. Wenn sie unterbrochen wurde und die globale Option mysqli.reconnect aktiviert ist, wird automatisch versucht, eine neue Verbindung herzustellen.

    Hinweis: Die php.ini-Einstellung mysqli.reconnect wird vom mysqlnd-Treiber ignoriert, so dass nie automatisch versucht wird, eine neue Verbindung herzustellen.

    Diese Funktion kann von Clients verwendet werden, die längere Zeit untätig sind, um zu überprüfen, ob der Server die Verbindung getrennt hat, und sich gegebenenfalls neu zu verbinden.

    Parameter-Liste

    mysql

    Nur bei prozeduralem Aufruf: ein von mysqli_connect() oder mysqli_init() zurückgegebenes mysqli-Objekt.

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

    Fehler/Exceptions

    If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR) and the requested operation fails, a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT, a mysqli_sql_exception is thrown instead.

    Beispiele

    Beispiel #1 mysqli::ping()-Beispiel

    Objektorientierter Stil

    <?php
    $mysqli     = new mysqli("localhost", "my_user", "my_password", "world");


    if ($mysqli->connect_errno) {
    printf("Verbindung fehlgeschlagen: %s\n", $mysqli->connect_error);
    exit();
    }


    if ($mysqli->ping()) {
    printf ("Unsere Verbindung ist OK!\n");
    } else {
    printf ("Fehler: %s\n", $mysqli->error);
    }


    $mysqli->close();
    ?>

    Prozeduraler Stil

    <?php
    $link     = mysqli_connect("localhost", "my_user", "my_password", "world");


    if (mysqli_connect_errno()) {
    printf("Verbindung fehlgeschlagen: %s\n", mysqli_connect_error());
    exit();
    }


    if (mysqli_ping($link)) {
    printf ("Unsere Verbindung ist OK!\n");
    } else {
    printf ("Fehler: %s\n", mysqli_error($link));
    }


    mysqli_close($link);
    ?>

    Die obigen Bespiele erzeugen folgende Ausgabe:

    Unsere Verbindung ist OK!
    To Top