pg_update

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_update Modifica las líneas de una tabla

Descripción

pg_update(
    PgSql\Connection $connection,
    string $table_name,
    array $values,
    array $conditions,
    int $flags = PGSQL_DML_EXEC
): string|bool

pg_update() modifica las líneas de la tabla table_name, que cumplen la condición conditions con values.

Si flags está especificado, pg_convert() se aplica a values con los flags proporcionados.

Por omisión pg_update() pasa valores sin tratar. Los valores deben ser escapados o el flag PGSQL_DML_ESCAPE debe ser especificado en flags. PGSQL_DML_ESCAPE añade comillas y escapa los argumentos/identificadores. Por lo tanto, los nombres de tabla/columnas se vuelven sensibles a mayúsculas/minúsculas.

Tenga en cuenta que ni el escape ni las consultas preparadas pueden proteger de consultas LIKE, JSON, arrays, Regex, etc. Estos argumentos deben ser tratados según su contexto. Es decir, escapar/validar los valores.

Parámetros

connection

An PgSql\Connection instance.

table_name

El nombre de la tabla en la que las líneas serán actualizadas.

values

Un tableau cuyos claves son los nombres de los campos en la tabla table_name, y donde los valores son las líneas correspondientes que serán actualizadas.

conditions

Un tableau cuyos claves son los nombres de los campos en la tabla table_name, y donde los valores son las condiciones que deben cumplir las líneas para ser actualizadas.

flags

Cualquier combinación de constantes entre PGSQL_CONV_FORCE_NULL, PGSQL_DML_NO_CONV, PGSQL_DML_ESCAPE, PGSQL_DML_EXEC, PGSQL_DML_ASYNC o PGSQL_DML_STRING. Si PGSQL_DML_STRING forma parte del argumento flags, entonces la consulta será devuelta. Cuando la constante PGSQL_DML_NO_CONV o la constante PGSQL_DML_ESCAPE está definida, no se realizará ninguna llamada a la función pg_convert() internamente.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error. Devuelve una chaîne de caractères si PGSQL_DML_STRING es pasado a través del argumento flags.

Historial de cambios

Versión Descripción
8.1.0 The connection parameter expects an PgSql\Connection instance now; previously, a recurso was expected.

Ejemplos

Ejemplo #1 Ejemplo con pg_update()

<?php
$db
= pg_connect ('dbname=foo');
$data = array('field1'=>'AA', 'field2'=>'BB');

// Esto es seguro en cierta medida, ya que todos los valores son escapados
// Sin embargo PostgreSSQL soporta JSON/arrays. Estos no
// son seguros ni por escape ni por consultas preparadas.
$res = pg_update($db, 'post_log', $_POST, $data);
if (
$res) {
echo
"Los datos han sido modificados: $res\n";
} else {
echo
"Problema en los datos del usuario\n";
}
?>

Ver también

  • pg_convert() - Convierte valores de un array asociativo a una forma adecuada para consultas SQL