sqlsrv_prepare
(没有可用的版本信息,可能只在Git中)
sqlsrv_prepare - 准备执行查询
描述
mixed sqlsrv_prepare ( resource $conn , string $sql [, array $params [, array $options ]] )
准备查询执行。该功能非常适用于准备将使用不同参数值多次执行的查询。
参数
conn
由sqlsrv_connect()返回的连接资源。
sql
定义要准备和执行的查询的字符串。
params
执行参数化查询时指定参数信息的数组。数组元素可以是以下任何一种:
- 字面值
- 一个PHP变量
- 具有这种结构的数组:array($ value [,$ direction [,$ phpType,$ sqlType]])
下表描述了上述数组结构中的元素:
元件 | 描述 |
---|---|
$值 | 一个字面值,一个PHP变量或一个PHP by-reference变量。 |
$方向(可选) | 以下SQLSRV常量之一用于指示参数方向:SQLSRV_PARAM_IN,SQLSRV_PARAM_OUT,SQLSRV_PARAM_INOUT。默认值是SQLSRV_PARAM_IN。 |
$ phpType(可选) | 指定返回值的PHP数据类型的SQLSRV_PHPTYPE_ *常量。 |
$ sqlType(可选) | 一个SQLSRV_SQLTYPE_ *常量,用于指定输入值的SQL Server数据类型。 |
options
指定查询属性选项的数组。下表中描述了支持的密钥:
键 | 值 | 描述 |
---|---|---|
的QueryTimeout | 一个正整数值。 | 以秒为单位设置查询超时。默认情况下,驱动程序将无限期地等待结果。 |
SendStreamParamsAtExec | TRUE或FALSE(默认值为TRUE) | 配置驱动程序在执行时发送所有流数据(TRUE),或以块(FALSE)发送流数据。默认情况下,该值设置为TRUE。有关更多信息,请参见sqlsrv_send_stream_data()。 |
滚动 | SQLSRV_CURSOR_FORWARD,SQLSRV_CURSOR_STATIC,SQLSRV_CURSOR_DYNAMIC或SQLSRV_CURSOR_KEYSET | 请参阅?在Microsoft SQLSRV文档中指定光标类型并选择行。 |
返回值
成功时返回语句资源并且发生错误时返回FALSE
例子
示例#1 sqlsrv_prepare()示例
此示例演示如何使用sqlsrv_execute()使用sqlsrv_prepare()准备语句并多次重复执行它(使用不同的参数值)。
<?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));
}
$sql?=?"UPDATE?Table_1
????????SET?OrderQty?=??
????????WHERE?SalesOrderID?=??";
//?Initialize?parameters?and?prepare?the?statement.?
//?Variables?$qty?and?$id?are?bound?to?the?statement,?$stmt.
$qty?=?0;?$id?=?0;
$stmt?=?sqlsrv_prepare(?$conn,?$sql,?array(?&$qty,?&$id));
if(?!$stmt?)?{
????die(?print_r(?sqlsrv_errors(),?true));
}
//?Set?up?the?SalesOrderDetailID?and?OrderQty?information.?
//?This?array?maps?the?order?ID?to?order?quantity?in?key=>value?pairs.
$orders?=?array(?1=>10,?2=>20,?3=>30);
//?Execute?the?statement?for?each?order.
foreach(?$orders?as?$id?=>?$qty)?{
????//?Because?$id?and?$qty?are?bound?to?$stmt1,?their?updated
????//?values?are?used?with?each?execution?of?the?statement.?
????if(?sqlsrv_execute(?$stmt?)?===?false?)?{
??????????die(?print_r(?sqlsrv_errors(),?true));
????}
}
?>
笔记
当您准备一个使用变量作为参数的语句时,变量将绑定到该语句。这意味着如果您更新变量的值,则在下次执行语句时,它将使用更新的参数值运行。对于您计划只执行一次的语句,请使用sqlsrv_query()。
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com