The only options that I see are:
PGSQL_CONV_IGNORE_DEFAULT - Do not use DEAFULT value by removing field from returned array
PGSQL_CONV_FORCE_NULL - Convert to NULL if string is null string
PGSQL_CONV_IGNORE_NOT_NULL - Ignore NOT NULL constraints
These are constants, so don't quote them or anything.
pg_convert
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_convert — Conviertir valores de un array asociativo en valores adecuados para sentencias SQL
Descripción
pg_convert(
resource
string
array
int
): array
resource
$connection,string
$table_name,array
$assoc_array,int
$options = 0): array
pg_convert() evalua y convierte los valores de un
assoc_array en valores adecuados para su uso en una sentencia
SQL. La condición previa para la función pg_convert() es la
existencia de una tabla con nombre igual al parametro table_name que tiene
por lo menos tantas columnas como elementos tiene el assoc_array. Los
nombres de campos en table_name deben coincidir con los índices de
assoc_array y los tipos de datos correspondientes deben ser
compatibles. Devuelve un array con los valores convertidos en caso de éxito, false
de lo contrario.
Nota:
Desde PHP 5.6.0, acepta valores booleanos. Se convierten a booleanos de PostgreSQL. También se admiten representaciones de string de valores booleanos.
nullse convierte al NULL de PostgreSQL.Antes de PHP 5.6.0, si existen campos booleanos en
table_name, no use la constantetrueenassoc_array. Será convertida al string 'TRUE', el cual no es una entrada válida para campos booleanos en PostgreSQL. Use t, true, 1, y, yes en su lugar.
Parámetros
-
connection -
Recurso de conexión de base de datos PostgreSQL.
-
table_name -
Nombre de la tabla contra la que convertir los tipos.
-
assoc_array -
Los datos que desea convertir.
-
options -
Cualquier número de
PGSQL_CONV_IGNORE_DEFAULT,PGSQL_CONV_FORCE_NULLóPGSQL_CONV_IGNORE_NOT_NULL, ó una combinación de estos.
Valores devueltos
Un array de valores convertidos, o false en caso de error.
Ejemplos
Ejemplo #1 Ejemplo de pg_convert()
<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'author' => 'Joe Thackery',
'year' => 2005,
'title' => 'My Life, by Joe Thackery'
);
$vals = pg_convert($dbconn, 'authors', $tmp);
?>
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.6.0 | Ya no es experimental. Se admiten los tipos de datos boolean/NULL. Los tipos de datos desconocidos/no soportados son escapados sin validación. Se podría emplear pg_convert() con cualquier tipo de dato. |
Ver también
- pg_meta_data() - Get meta data for table
- pg_insert() - Insert array into table
- pg_select() - Select records
- pg_update() - Actualizar tabla
- pg_delete() - Borra registros
add a note
User Contributed Notes 5 notes
Anonymous ¶
20 years ago
gorhas at gmail dot com ¶
9 years ago
There is a problem when using interval.
If in the array
"time_pause" => '00:30:00'
and time_pause is an interval
the insert fails
pg_insert(): '00:30:00' does not match with '^(@?[ \t]+)?((([-+]?[ \t]+)?[0-9]+(\.[0-9]*)?[ ...
dharana at dharana dot net ¶
20 years ago
I've found "options" possible values:
PG_CONV_CHECK - check only
PG_CONV_STRICT - raise warning for non fatal error
PG_CONV_QUOTE - add quote around values for vchar, text datetime.
PG_CONV_SLASH - add slashes if it needed.
PG_CONV_NULLCHK - check values are defined for NOT NULL fields.
PG_CONV_NO_DEFAULT - ignore default value even if value is empty string.
VLroyrenn ¶
6 years ago
Another thing that's not well documented is that (as of PHP 7.0/7.1) pg_convert doesn't like non-scalar types and will fail (but not throw just emit an E_WARNING and return false) if you pass it anything other than a string or a number, including an array or something like a DateTime. If you want to insert those types, you actually have to convert those yourself.
Also, somewhat surprisingly, $table_name is not compatible with the output of pg_escape_identifier, or seemingly any other kind of escaping.
Hayley Watson ¶
6 years ago
This will only apply the appropriate escaping and such appropriate for embedding the PHP value into an SQL statement.
It does (by default) check for nulls when the column is marked NOT NULL, and it will complain about trying to convert strings for an integer column (floats will be truncated).
Beyond the barest checking of syntax, however, it does NOT verify that the given value is a legitimate value for the column type.
<?php
// Assuming smallints.smallintis a smallint (-32768..32767) type column
foreach([-1234,
1234,
0,
32767,
-32768,
32768, // bogus value for smallint type
45.8, // gets truncated to 45
400000, // bogus value for smallint type
] as $smallint)
{
$tmp = ['smallint' => $smallint];
$vals = pg_convert($dbconn, 'smallints', ['smallint' => $smallint]);
echo $vals['"smallint"'],"\n"; // Notice the column name is also made SQL-safe
}
// Assuming uuids.uuid is a UUID type column
foreach(['a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11',
'A0EEBC99-9C0B-4EF8-BB6D-6BB9BD380A11',
'a0eebc999c0b4ef8bb6d6bb9bd380a11',
'{a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11}',
'Invalid Not-a-UUID',
'{a0eebc99-9c0b4ef8-bb6d6bb9-bd380a11}',
'a0ee-bc99-9c0b-4ef8-bb6d-6bb9-bd38-0a11',
] as $uuid)
{
$tmp = ['uuid' => $uuid];
$vals = pg_convert($dbconn, 'uuids', ['uuid' => $uuid]);
echo $vals['"uuid"'],"\n";
}
?>
All of the above data values will be "converted" - even the invalid ones - without complaint.
