pg_convert

(PHP 4 >= 4.3.0, PHP 5)

pg_convert — Convertit des tableaux associatifs en une commande PostgreSQL

Description

array pg_convert ( resource $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 danstable_name, n'utilisez pas la constante TRUE dans assoc_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".

Liste de paramètres

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é.

Valeurs de retour

Un tableau des valeurs converties ou FALSE en cas d'erreur.

Exemples

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);
?>

Historique

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.

Voir aussi