在线文档教程
PHP

pg_execute

pg_execute

(PHP 5 >= 5.1.0, PHP 7)

pg_execute - 发送一个请求来执行给定参数的预处理语句,并等待结果。

描述

resource pg_execute ([ resource $connection ], string $stmtname , array $params )

发送一个请求来执行给定参数的预处理语句,并等待结果。

pg_execute()与pg_query_params()类似,但要执行的命令是通过命名预先准备的语句来指定的,而不是给出查询字符串。该功能允许重复使用的命令只被解析和计划一次,而不是每次执行它们。该声明必须在本届会议上进行过。pg_execute()仅支持PostgreSQL 7.4或更高版本的连接; 使用早期版本时会失败。

这些参数与pg_query_params()相同,不同之处在于给定的语句的名称不是查询字符串。

参数

connection

PostgreSQL数据库连接资源。如果connection不存在,则使用默认连接。默认连接是pg_connect()或pg_pconnect()所做的最后一个连接。

stmtname

准备执行的语句的名称。如果指定了“”,那么执行未命名的语句。该名称必须先使用pg_prepare(),pg_send_prepare()或PREPARE SQL命令进行准备。

params

用于替换原始准备的查询字符串中的$ 1,$ 2等占位符的参数值数组。数组中元素的数量必须与占位符的数量相匹配。

警告

通过调用此函数将元素转换为字符串。

返回值

成功返回查询结果资源或失败时返回FALSE

Examples

Example #1 Using pg_execute()

<?php // Connect to a database named "mary" $dbconn = pg_connect("dbname=mary" // Prepare a query for execution $result = pg_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1' // Execute the prepared query.  Note that it is not necessary to escape // the string "Joe's Widgets" in any way $result = pg_execute($dbconn, "my_query", array("Joe's Widgets") // Execute the same prepared query, this time with a different parameter $result = pg_execute($dbconn, "my_query", array("Clothes Clothes Clothes") ?>