mysql_close

(PHP 4, PHP 5)

mysql_close — Schließt eine Verbindung zu MySQL

Warnung

Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt. Verwenden Sie stattdessen die Erweiterungen MySQLi oder PDO_MySQL. Weitere Informationen bietet der Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:

mysqli_close()
PDO: Zuweisung des Wertes null zum PDO-Objekt

Beschreibung

mysql_close(resource $link_identifier = NULL): bool

mysql_close() schließt die nicht persistente Verbindung zum MySQL-Server, die mit der angegebenen Verbindungskennung verknüpft ist. Wird link_identifier nicht angegeben, wird die zuletzt geöffnete Verbindung geschlossen.

Offene nicht-persistente MySQL Verbindungen und Ergebnismengen werden automatisch zerstört, wenn ein PHP-Skript seine Ausführung beendet. Obwohl also das explizite Schließen von offenen Verbindungen und das Freigeben von Ergebnismengen optional ist, wird es dennoch empfohlen. Dadurch werden Ressourcen unmittelbar an PHP und MySQL zurückgeben, was die Performance verbessern kann. Weitere Informationen sind unter Freigeben von Ressourcen zu finden.

Parameter-Liste

link_identifier: Die MySQL Verbindung. Wenn nicht angegeben, wird die letzte mit mysql_connect() geöffnete Verbindung verwendet. Wenn noch keine Verbindung hergestellt wurde wird ein E_WARNING Fehler geworfen.

Rückgabewerte

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

Beispiele

Beispiel #1 mysql_close()-Beispiel

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Keine Verbindung möglich: ' . mysql_error());
}
echo 'Erfolgreich verbunden';
mysql_close($link);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Erfolgreich verbunden

Anmerkungen

Hinweis:
mysql_close() schließt keine persistenten Verbindungen, die mit mysql_pconnect() geöffnet wurden. Weitere Details sind der Manpage über Persistente Verbindungen zu entnehmen.

Siehe auch

mysql_connect() - Öffnet eine Verbindung zu einem MySQL-Server
mysql_free_result() - Gibt belegten Speicher wieder frei

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 4 notes

down

bbodelcampo at yahoo dot co dot uk ¶

18 years ago

A little note about multiple simultaneous connections to different hosts...



I work on a site that pulls content primarily from one db but uses a db on a foreign server to verify licensing.  One might expect the following to work:



<?php

// Open the connection to the primary db

$res1 = mysql_connect($host1, $user1, $pass1);

mysql_select_db($db1);



// Open connection to the license server

$res2 = mysql_connect($host2, $user2, $pass2);

mysql_select_db($db2, $res2);



// Pull license data and close when done

mysql_query($check_sql, $res2);

// ...

mysql_close($res2);



// Now pull content from the primary db

// Not specifying the resource should default to the last open db

mysql_query($query); 

// ...

?>



Turns out this last query, since it cant find an active connection, will try to connect with mysql_connect() with no paramaters.  But if instead you do it as mysql_query($query, $res1), or alternatively, run the mysql_connect for this host again then it works fine.  Thus, it doesnt seem to be possible to have code with an overarching "global" db connection interspersed with temporary connections to another host/db....

down

-6

mdes[SPAM]saintes at gmail dot com ¶

13 years ago

i just came over a problem that i had with apache.

It crashs and said :

"Parent: child process exited with status 3221225477 -- Restarting."

the error came from the extesion php_mysql.dll

i didn't understand what was the reason of that crash..

Then, i debug the script that i had downloaded and i noticed that that was the function mysql_close() which caused the problem.

The solution is, to send to it the link identifier which is optionnal in the description but cause a crash with no commentary.

Thanks to agneady.

down

-7

Anonymous ¶

14 years ago

At least with PHP5.3.2 and Windows connecting by tcp, you should always use this mysql_close() function to close and free up the tcp socket being used by PHP.  Garbage collection after script execution does not close the tcp socket on its own.  The socket would otherwise remain in 'wait' state for approximately 30 seconds, and any additional page loads/connection attempts would only add to the total number of open tcp connections.  This wait time does not appear to be configurable via PHP settings.

down

-9

omega99999 at gmail dot com ¶

13 years ago

The variable is definitely not optional in 5.3... Caused me a bit of a headache when I was debugging until I realized it was the close function that was causing a hang. So if using just:

<?php
mysql_connect(<...>);

mysql_close();
?>

Use:

<?php
$connection = mysql_connect(<...>);

mysql_close($connection);
?>

(where $connection is any variable of your choice)

＋add a note