PHP Conference Japan 2024

sqlsrv_free_stmt

(无版本信息可用,可能仅在 Git 中)

sqlsrv_free_stmt释放指定语句的所有资源

描述

sqlsrv_free_stmt(资源 $stmt): 布尔值

释放指定语句的所有资源。在对语句调用 sqlsrv_free_stmt() 后,该语句将无法使用。如果在更改服务器状态的正在进行的语句上调用 sqlsrv_free_stmt(),则语句执行将终止,并且语句将回滚。

参数

stmt

要释放其资源的语句。请注意,null 是一个有效的参数值。这允许在脚本中多次调用该函数。

返回值

成功时返回 true,失败时返回 false

示例

示例 #1 sqlsrv_free_stmt() 示例

<?php
$serverName
= "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if(
$conn === false ) {
die(
print_r( sqlsrv_errors(), true));
}

$stmt = sqlsrv_query( $conn, "SELECT * FROM Table_1");
if(
$stmt === false ) {
die(
print_r( sqlsrv_errors(), true));
}

/*-------------------------------
在此处处理查询结果。
-------------------------------*/

/* 释放语句资源。 */
sqlsrv_free_stmt( $stmt);

?>

注释

sqlsrv_free_stmt()sqlsrv_cancel() 之间的主要区别在于,使用 sqlsrv_cancel() 取消的语句资源如果使用 sqlsrv_prepare() 创建,则可以重新执行。使用 sqlsrv_free_statement() 取消的语句资源无法重新执行。

参见

添加注释

用户贡献的注释 1 条注释

匿名
9 年前
如果您意外地使用无效的 $stmt 资源调用此函数,则可能会看到意外的致命错误。

在清理一些代码时,我在这里留下了一个调用,这导致我的 IIS 服务器生成一个错误 500 资源未找到错误。此外,它似乎只影响某些用户,而不是所有用户,我无法隔离为什么只有选定的用户在为所有用户调用时会收到错误。
To Top