- PHP 手册
- 函数参考
- 数据库扩展
- 针对各数据库系统对应的扩展
- MySQL
- Mysql（原始）
- MySQL 函数
mysql_free_result
(PHP 4, PHP 5)
mysql_free_result — 释放结果内存
说明
mysql_free_result(resource$result): bool
mysql_free_result() 将释放所有与结果标识符
result 所关联的内存。
mysql_free_result() 仅需要在考虑到返回很大的结果集时会占用多少内存时调用。在脚本结束后所有关联的内存都会被自动释放。
成功时返回 true， 或者在失败时返回 false。
为向下兼容仍然可以使用 mysql_freeresult()，但反对这样做。
参数
-
result -
resource 型的结果集。此结果集来自对 mysql_query() 的调用。
返回值
成功时返回 true， 或者在失败时返回 false。
If a non-resource is used for the result, an
error of level E_WARNING will be emitted. It's worth noting that
mysql_query() only returns a resource
for SELECT, SHOW, EXPLAIN, and DESCRIBE queries.
范例
示例 #1 A mysql_free_result() example
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Could not run query: ' . mysql_error();
exit;
}
/* Use the result, assuming we're done with it afterwards */
$row = mysql_fetch_assoc($result);
/* Now we free up the result and continue on with our script */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>
注释
注意:
为了向下兼容，可以使用下列已废弃的别名： mysql_freeresult()
参见
- mysql_query() - 发送一条 MySQL 查询
- is_resource() - 检测变量是否为资源类型
User Contributed Notes 3 notes
up down 12 webmaster at bluesting dot co dot za ¶11 years ago
mysql_query() also returns a resource for "OPTIMIZE TABLE" statements!
up
down
12
admin at ifyouwantblood dot de ¶14 years ago
yes this function may increase the memory usage if you use unbuffered querys and if you have not fetched all the data from mysql. in this case the mysql api has a problem: you want to free the result but do not want to close the connection. now mysql will only accept another query if all data has been fetched, so the api now must fetch the rest of the data when calling mysql_free_result().
so only use unbuffered querys if you fetch all the data (and need it).
up
down
-30
Anonymous ¶15 years ago
If you're seeing warnings like "Warning: Unknown: 6 result set(s) not freed. Use mysql_free_result to free result sets which were requested using mysql_query() in Unknown on line 0" and want to turn them off, set mysql.trace_mode = Off in your php.ini
add a note
官方地址：https://www.php.net/manual/en/function.mysql-free-result.php