PHP 8.5.0 Alpha 1 available for testing

pg_execute

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

pg_execute Ejecuta una consulta preparada de PostgreSQL

Descripción

pg_execute(PgSql\Connection $connection = ?, string $stmtname, array $params): PgSql\Result|false

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.

Parámetros

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().

Advertencia

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.

Advertencia

Los elementos son convertidos en strings al llamar a esta función.

Valores devueltos

Una instancia de PgSql\Result en caso de éxito, o false en caso de error.

Historial de cambios

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.

Ejemplos

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"));

?>

Ver también

  • pg_prepare() - Envía una solicitud al servidor para crear una sentencia preparada con los parámetros dados y espera la ejecución
  • pg_send_prepare() - Envía una solicitud para crear una consulta preparada con los argumentos dados, sin esperar el final de su ejecución
  • pg_query_params() - Envía un comando al servidor y espera el resultado, con la capacidad de pasar parámetros por separado del texto SQL de la consulta

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top