pg_convert

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

pg_convert — Convertit des valeurs d'un tableaux associatifs en une forme convenable pour des requêtes SQL

Description

pg_convert ( resource $connection , string $table_name , array $assoc_array [, int $options = 0 ] ) : array

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:

À partir de PHP 5.6.0, la fonction accepte les valeurs booléennes, les convertissant en booléen PostgreSQL. Les représentations de valeurs booléennes sous forme de chaînes de caractères sont également supportées. NULL est converti en NULL PostgreSQL.

Antérieur à 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() peut être utilisée pour tous les types de données.

Voir aussi