9.4.3 Disconnecting from a MySQL database: mysql_free_result() and mysql_close()This is NOT the latest copy of this book; click here for the latest version.
bool mysql_free_result ( resource result)
bool mysql_close ( [resource link_identifier])
When your PHP script is finished, PHP will automatically perform garbage collection on the objects and resources you used therein. As result of this, plus the fact that most scripts are over in less than a tenth of a second, it is generally not necessary to explicitly disconnect from your MySQL server or to hand-free the space allocated to your SQL results.
However, in the situation where you have a popular script that takes a long time to execute, perhaps over five to ten seconds, you should really try to do all you can to conserve memory and resources, and therefore it is smart to explicitly free up your MySQL resources rather than waiting to let PHP do it on your behalf.
To this end, there are two functions that you should be making use of: mysql_free_result() and mysql_close().
The mysql_free_result() function is used to de-allocate memory that was used to store the query results returned by mysql_query(). If you have particularly big queries being returned, then you should definitely be calling mysql_free_result() if there is a big length of time between you being finished with the data and your script finishing execution. Here is how it works:
<?php
$result = mysql_query("SELECT * FROM really_big_table;");
...[snip]...
mysql_free_result($result);
?>
The purpose of mysql_close() is also to save computer resources, but another key reason for using it is because there is a limited number of connections that a MySQL server can accept, and if you have several clients holding connections open for no reason then the server may well need to turn away other, waiting clients. Naturally this is a bad thing, so, as with mysql_free_result(), it is good to call mysql_close() if you think there will be some time between your last database use and your script ending.
Using mysql_close() is simple - you do not need to supply any parameters to it, as it will automatically close the last-opened MySQL connection. Of course, if you captured the return value from mysql_connect(), you can supply that to mysql_close() and it will close a specific connection - handy if you have multiple MySQL connections open for some reason.
So, here's a very simple example of mysql_close() in action:
<?php
mysql_connect("localhost", "phpuser", "alm65z");
mysql_select_db("phpdb");
...[snip]...
mysql_close();
?>
As you can see, it is very simple to use. As shown above, it is not really important - the script ends, and any open MySQL connections that aren't permanent connections will be closed automatically.
|
Want to see this stuff in print? PHP in a Nutshell takes the core topics covered here, adds in thousands of edits from the editorial team and myself, and combines them to make an unbeatable reference for PHP programmers at all levels.
My latest book has hundreds more tips on how to use PHP, Apache, and MySQL, plus Perl, Python, shell scripts, performance tuning, and more!
|
