mysql_close
Данный модуль устарел, начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API. Альтернативы для данной функции:
- mysqli_close()
- PDO: Присвоить значение null объекту PDO
Описание
mysql_close() закрывает непостоянное соединение с базой данных MySQL, на которое указывает переданный дескриптор. Если параметр link_identifier не указан, закрывается последнее открытое (текущее) соединение.
Открытые непостоянные соединения MySQL и результирующие наборы автоматически удаляются сразу по окончании работы PHP-скрипта. Следовательно, закрывать соединения и очищать результирующие наборы не обязательно, но рекомендуется, так как это сразу же освободит ресурсы базы данных и память, занимаемую результатами выборки, что может положительно сказаться на производительности. Больше информации можно почерпнуть в разделе Освобождение ресурсов
Список параметров
Соединение MySQL. Если не указано, то используется последнее соединение, открытое mysql_connect() . Если соединение не найдено или не установлено, то будет сгенерирована ошибка уровня E_WARNING .
Возвращаемые значения
Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.
Примеры
Пример #1 Пример использования mysql_close()
Результат выполнения данного примера:
Примечания
Замечание:
mysql_close() не закрывает постоянные соединения, созданные функцией mysql_pconnect() . Для дополнительной информации смотрите руководство по постоянным соединениям.
Смотрите также
- mysql_connect() — Открывает соединение с сервером MySQL
- mysql_free_result() — Освобождает память от результата запроса
User Contributed Notes 6 notes
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.
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.
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:
mysql_close ( $connection );
?>
(where $connection is any variable of your choice)
As at 5.0.x and 4.3.x: This function should never be used with shared links; instead you should set your link variables to null.
(This explains red’s and beer’s () problems in previous comments)
Here is how shared links work:
— Each link is a resource. mysql_connect() by default looks for a resource with the same paramaters. If one exists, it will return the existing resource.
— Every assignment of that resource to a variable increases the resource’s reference count.
— When the reference is decremented to zero, the underlying TCP/socket connection is closed.
— Every assignment of a variable away from that resource decrements the reference count. (This includes a function level variable going out of scope)
— mysql_close() also decrements the reference count.
Note the last two points: mysql_close() _and_ reassignment of a variable decrement the link’s reference count.
A common mistake is a function like:
<?php
function dothings () <
$link = mysql_open (. );
// .. do some queries ..
mysql_close ( $link )
$link = null ;
>
?>
this will decrement the counter twice, possibly closing the underlying connection and causing errors in other parts of the program.
mysql_close
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
mysql_close() закрывает соедиение с базой данных MySQL, на которое указывает переданный указатель. Если параметр link_identifier не указан, закрывается последнее открытое (текущее) соединение.
Использование mysql_close() не необходимо для непостоянных соединений. Они автоматически закрываются в конце скрипта. Смотрите также высвобождение ресурсов.
Замечание: mysql_close() не может закрывать постоянные соединения, открытые функцией mysql_pconnect() .
mysqli::close
Открытые неперсистентные соединения MySQL и наборы результатов автоматически закрываются при уничтожении их объектов.Явное закрытие открытых соединений и освобождение наборов результатов необязательно.Однако,хорошей идеей будет закрыть соединение,как только сценарий завершит выполнение всех операций с базой данных,если после получения результатов ему предстоит еще много обработки.
Parameters
Только процедурный стиль: объект mysqli, возвращаемый mysqli_connect () или mysqli_init ()
Return Values
Возвращает true в случае успеха или false в случае неудачи.
mysqli_close
Открытые непостоянные соединения MySQL и наборы результатов автоматически закрываются при уничтожении их объектов. Явное закрытие открытых соединений и освобождение наборов результатов не обязательно. Однако рекомендуется закрыть соединение, как только скрипт завершит выполнение всех своих операций с базой данных, если ему ещё предстоит большая обработка после получения результатов.
Список параметров
Только для процедурного стиля: объект mysqli , полученный с помощью mysqli_connect() или mysqli_init() .
Возвращаемые значения
Функция всегда возвращает true .
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 | Функция теперь возвращает значение true . Ранее она возвращала значение false в случае возникновения ошибки. |
Примеры
Пример #1 Пример использования mysqli::close()
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 ) <
/* Обработка данных, полученных из базы данных */
>
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() не закрывает постоянные соединения. Для получения подробностей смотрите руководство по persistent connections.