Edit Report a Bug

    mysqli::close

    mysqli_close

    (PHP 5, PHP 7, PHP 8)

    mysqli::close -- mysqli_close — Closes a previously opened database connection

    Description

    Object-oriented style

    public mysqli::close(): true

    Procedural style

    mysqli_close(mysqli $mysql): true

    Closes a previously opened database connection.

    Open non-persistent MySQL connections and result sets are automatically closed when their objects are destroyed. Explicitly closing open connections and freeing result sets is optional. However, it's a good idea to close the connection as soon as the script finishes performing all of its database operations, if it still has a lot of processing to do after getting the results.

    Parameters

    mysql

    Procedural style only: A mysqli object returned by mysqli_connect() or mysqli_init()

    Return Values

    Always returns true.

    Changelog

    Version Description
    8.0.0 This function now always returns true. Previously it returned false on failure.

    Examples

    Example #1 mysqli::close() example

    Object-oriented style

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $result = $mysqli->query("SELECT Name, CountryCode FROM City ORDER BY ID LIMIT 3");

    /* Close the connection as soon as it's no longer needed */
    $mysqli->close();

    foreach (    $result as $row) {
    /* Processing of the data retrieved from the database */
    }

    Procedural style

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");

    $result = mysqli_query($mysqli, "SELECT Name, CountryCode FROM City ORDER BY ID LIMIT 3");

    /* Close the connection as soon as it's no longer needed */
    mysqli_close($mysqli);

    foreach (    $result as $row) {
    /* Processing of the data retrieved from the database */
    }

    Notes

    Note:

    mysqli_close() will not close persistent connections. For additional details, see the manual page on persistent connections.

    See Also

    add a note add a note

    User Contributed Notes 1 note

    up
    -38
    php at dafydd dot com
    16 years ago
    I've had situations where database connections appeared to persist following php execution. So, now, my __destructor function explicitly contains a $cxn->close(). It hurts nothing, and helps avoid memory leaks.
    add a note add a note
    To Top