mysql_close

(PHP 4, PHP 5)

mysql_close — Ferme la connexion MySQL

Avertissement

Cette extension était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez utiliser l'extension MySQLi ou l'extension PDO_MySQL. Voir aussi MySQL : choisir une API du guide. Alternatives à cette fonction :

mysqli_close()
PDO : Assigne la valeur null à l'objet PDO

Description

mysql_close(resource $link_identifier = NULL): bool

mysql_close() ferme la connexion non persistante au serveur MySQL associée à l'identifiant spécifié. Si link_identifier n'est pas spécifié, cette commande s'applique à la dernière connexion ouverte.

Les connexions et les jeux de résultats ouverts de façon non persistantes sont automatiquement détruits lorsqu'un script PHP termine son exécution. Aussi, le fait de fermer une connexion et libérer les résultats étant optionnel, le fait de le faire explicitement est néanmoins vivement recommandé. Ceci va retourner les ressources immédiatement à PHP et à MySQL, ce qui va améliorer les performance. Pour plus d'informations, référez-vous à la libération des ressources

Liste de paramètres

link_identifier: La connexion MySQL. Si l'identifiant du lien n'est pas spécifié, la dernière connexion ouverte avec la fonction mysql_connect() sera utilisée. Si aucune connexion n'est trouvée ou établie, une alerte de niveau E_WARNING sera générée.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec mysql_close()

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Connexion impossible : ' . mysql_error());
}
echo 'Connexion réussie';
mysql_close($link);
?>

L'exemple ci-dessus va afficher :

Connexion réussie

Notes

Note:
mysql_close() ne fermera pas les connexions persistantes créées par mysql_pconnect(). Pour plus de détails, voir la page du manuel sur les connexions persistentes.

Voir aussi

mysql_connect() - Ouvre une connexion à un serveur MySQL
mysql_free_result() - Libère le résultat de la mémoire

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