pg_prepare
Envía una solicitud al servidor para crear una sentencia preparada con los parámetros
dados y espera la ejecución
&reftitle.description;
PgSql\Resultfalsepg_prepare
PgSql\Connectionconnection
stringstatement_name
stringquery
pg_prepare crea una consulta preparada para una
ejecución posterior con pg_execute o
pg_send_execute.
Esta característica permite que las órdenes que serán utilizadas
repetidamente sean analizadas y planificadas una sola vez,
en lugar de ser ejecutadas cada vez.
La función crea una consulta preparada llamada
statement_name a partir de la cadena
query, la cual debe contener una sola orden
SQL. statement_name puede ser "" para crear una
consulta sin nombre. En este caso, las consultas que existían y
que no tenían nombres son automáticamente sobrescritas; de lo contrario, habrá un error si el nombre de la consulta ya está definido en la sesión actual. Si se utilizan parámetros, estos son referenciados como $1,
$2, etc.
en query.
Las consultas preparadas para ser utilizadas con pg_prepare
también pueden ser creadas ejecutando la orden SQL
PREPARE. (Sin embargo, pg_prepare
es más flexible ya que no requiere que los tipos de los parámetros
sean preespecificados.) Además, aunque no existe una función PHP para
eliminar una consulta preparada, la orden SQL
DEALLOCATE puede ser utilizada para este propósito.
&reftitle.parameters;
connection
&pgsql.parameter.connection-with-unspecified-default;
statement_name
El nombre a dar a la consulta preparada. Debe ser único para cada
sesión. Si se especifica una cadena vacía "" entonces se crea una consulta sin
nombre, sobrescribiendo las consultas sin nombres previamente definidas.
query
La consulta SQL con sus parámetros. Debe contener solo una sola
consulta. Varios comandos separados por punto y coma no son
permitidos. Si se utilizan parámetros, estos son referenciados como
$1, $2, etc.
&reftitle.returnvalues;
Una instancia PgSql\Result en caso de éxito, &return.falseforfailure;.
&reftitle.changelog;
&Version;
&Description;
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
Ejemplo con pg_prepare
]]>
&reftitle.seealso;
pg_execute
pg_send_execute