(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_convert — Convertit des tableaux associatifs en une commande PostgreSQL
$connection
, string $table_name
, array $assoc_array
[, int $options
= 0
] )
pg_convert() vérifie et convertit le tableau
associatif assoc_array
en une requête SQL valide.
Pour que pg_convert() fonctionne, il faut que la table
table_name
existe, et contienne au moins autant de colonnes
que le tableau assoc_array
a d'éléments. Les noms des
champs de table_name
doivent correspondre aux index
du tableau dans assoc_array
.
Retourne un tableau avec les valeurs converties en cas de succès, et sinon,
FALSE
.
Note:
Depuis PHP 5.6.0, la fonction accepte des valeurs booléennes. Ces valeurs seront converties en booléen PostgreSQL. Les représentations sous forme de chaînes de caractères d'une valeur booléenne sont également supportées.
NULL
sera converti en NULL PostgreSQL.Avant PHP 5.6.0, s'il y a des champs de type booléen dans
table_name
, n'utilisez pas la constanteTRUE
dansassoc_array
. Elle sera convertie en chaîne de caractères "TRUE" qui ne sera pas une entrée valide pour un champ booléen en PostgreSQL. Utilisez une de ces valeurs à la place : "t", "true", "1", "y", "yes".
connection
Ressource de connexion de base de données PostgreSQL.
table_name
Nom de la table sur pour laquelle les types seront convertis.
assoc_array
Données à être converties.
options
Un nombre de PGSQL_CONV_IGNORE_DEFAULT
,
PGSQL_CONV_FORCE_NULL
ou
PGSQL_CONV_IGNORE_NOT_NULL
, combiné.
Un tableau des valeurs converties ou FALSE
en cas d'erreur.
Exemple #1 Exemple avec pg_convert()
<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'auteur' => 'Joe Thackery',
'annee' => 2005,
'titre' => 'Ma Vie, par Joe Thackery'
);
$vals = pg_convert($dbconn, 'auteurs', $tmp);
?>
Version | Description |
---|---|
5.6.0 | La fonction n'est plus expérimentale. Les types de données booléen/NULL sont supportés. Les types de données inconnus/non supportés sont échappés dans validation. La fonction pg_convert() doit être utilisée pour tous les types de données. |