mysqli::close

mysqli_close

(PHP 5, PHP 7, PHP 8)

mysqli::close -- mysqli_close — 事前にオープンしているデータベース接続を閉じる

説明

オブジェクト指向型

public mysqli::close(): true

手続き型

mysqli_close(mysqli $mysql): true

既に開いているデータベース接続を閉じます。

既に開いている、持続的でない MySQL 接続と、結果セットはオブジェクトが破棄されるとすぐに閉じられます。既に開いている接続と結果セットを明示的に閉じるのはオプションですが、データベースから結果を取得した後、大量に処理が残っている場合、データベースに関する処理を全て実行し終わったらすぐに接続を閉じるのが望ましいです。

パラメータ

link: 手続き型のみ: mysqli_connect() あるいは mysqli_init() が返す mysqliオブジェクト。

戻り値

常に true を返します。

変更履歴

バージョン説明

8.0.0 この関数は、常に true を返すようになりました。これより前のバージョンでは、失敗時に false を返していました。

バージョン	説明
8.0.0	この関数は、常に `true` を返すようになりました。これより前のバージョンでは、失敗時に `false` を返していました。

例

例1 mysqli::close() example

オブジェクト指向型

<?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");
/* 不要になったらすぐに、接続を閉じます */
$mysqli->close();
foreach ($result as $row) {
    /* データベースから取得したデータを処理します */
}

手続き型

<?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");
/* 不要になったらすぐに、接続を閉じます */
mysqli_close($mysqli);
foreach ($result as $row) {
    /* データベースから取得したデータを処理します */
}

注意

注意:
mysqli_close() は、持続的な接続を閉じません。詳細な情報は、マニュアルの持続的データベース接続を参照ください。

参考

mysqli::__construct() - 新規に MySQL サーバーへの接続をオープンする
mysqli_init() - MySQLi を初期化し、mysqli_real_connect() で使うオブジェクトを返す
mysqli_real_connect() - mysql サーバーとの接続をオープンする
mysqli_free_result() - 結果に関連付けられたメモリを開放する