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

# 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 dans`table_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

- pg_meta_data() - Lit les métadonnées de la table PostgreSQL
- pg_insert() - Insère un tableau dans une table
- pg_select() - Effectue une sélection PostgreSQL
- pg_update() - Modifie les lignes d'une table
- pg_delete() - Efface des lignes PostgreSQL