(PHP 5 >= 5.1.0, PHP 7, PHP 8)
pg_execute — Ejecuta una consulta preparada de PostgreSQL
Envía una consulta para ejecutar una consulta preparada con los argumentos dados y espera el resultado.
pg_execute() es similar a pg_query_params(), pero la consulta que será ejecutada se especifica nombrando una consulta previamente preparada, en lugar de proporcionar una cadena como consulta. Esta característica permite que las consultas que serán utilizadas repetidamente sean analizadas y planificadas una sola vez, en lugar de ser ejecutadas cada vez. La consulta debe haber sido previamente preparada en la sesión actual. pg_execute() es soportada solo con las versiones PostgreSQL 7.4 o más recientes; la consulta fallará si se utiliza con versiones anteriores.
Los argumentos son idénticos a la función pg_query_params() excepto por el nombre de la consulta preparada que se proporciona en lugar de la consulta en forma de cadena.
connection
An PgSql\Connection instance.
When connection
is unspecified, the default connection is used.
The default connection is the last connection made by pg_connect()
or pg_pconnect().
As of PHP 8.1.0, using the default connection is deprecated.
stmtname
El nombre de la consulta preparada a ejecutar. Si se especifica una cadena vacía (""),
entonces se ejecuta la consulta sin nombre. El nombre debe haber sido previamente preparado
utilizando pg_prepare(), pg_send_prepare()
o una orden SQL PREPARE
.
params
Un array de valores de argumentos para sustituir las variables $1, $2, etc. en la consulta preparada original. El número de elementos presentes en el array debe coincidir con el número de variables a reemplazar.
Los elementos son convertidos en strings al llamar a esta función.
Una instancia de PgSql\Result en caso de éxito, o false
en caso de error.
Versión | Descripción |
---|---|
8.1.0 | Returns an PgSql\Result instance now; previously, a recurso was returned. |
8.1.0 |
The connection parameter expects an PgSql\Connection
instance now; previously, a recurso was expected.
|
Ejemplo #1 Ejemplo con pg_execute()
<?php
// Conexión a una base de datos llamada "marie"
$dbconn = pg_connect("dbname=marie");
// Prepara una consulta para su ejecución
$result = pg_prepare($dbconn, "my_query", 'SELECT * FROM magasins WHERE nom = $1');
// Ejecuta la consulta preparada. Observe que no es necesario escapar
// la cadena "Joe's Widgets"
$result = pg_execute($dbconn, "my_query", array("Joe's Widgets"));
// Ejecuta la misma consulta preparada, esta vez con un argumento diferente
$result = pg_execute($dbconn, "my_query", array("Vêtements Vêtements Vêtements"));
?>