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
&reftitle.description;
PgSql\Resultfalsepg_query_paramsPgSql\Connectionconnectionstringqueryarrayparams
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.
pg_query_params es como pg_query,
pero ofrece funcionalidades adicionales: los valores de los parámetros
pueden especificarse por separado de la línea de comando propia.
Si se utilizan parámetros, se refieren a $1, $2, etc. en
query. El mismo parámetro puede aparecer más de una vez
en la consulta query; se utilizará el mismo valor
en ese caso. params especifica los
valores actuales de los parámetros. Un valor &null; en este array
significa que el parámetro correspondiente es SQL &null;.
La principal ventaja de pg_query_params sobre
pg_query es que los valores de los parámetros pueden
separarse de la consulta query, por lo tanto,
se evitan los escapes de caracteres tediosos y propensos a errores.
A diferencia de pg_query,
pg_query_params permite solo un comando
SQL en la cadena dada. (Puede haber puntos y coma en
el interior pero no más de un comando.)
&reftitle.parameters;
connection
&pgsql.parameter.connection-with-unspecified-default;
query
La consulta SQL con sus parámetros. Debe contener solo una
consulta. Múltiples consultas separadas por puntos y coma no están
permitidas. Si se utilizan parámetros, se refieren a
$1, $2, etc.
Los valores proporcionados por el usuario siempre deben
pasarse como parámetros, y no interpolados en la cadena de
consulta, donde pueden potencialmente formar
inyecciones SQL
e introducir errores cuando estos datos contienen comillas.
Si por alguna razón no se pueden utilizar parámetros,
asegúrese de que los valores interpolados estén
correctamente escapados.
params
Un array de valores de parámetros 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 valores esperados para los campos bytea no son
soportados como parámetros. Utilice en su lugar la función
pg_escape_bytea o utilice las funciones sobre los
objetos grandes.
&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_query_params
]]>
&reftitle.seealso;
pg_query