pg_convert

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

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

Description

pg_convert(
    PgSql\Connection $connection,
    string $table_name,
    array $values,
    int $flags = 0
): array|false

pg_convert() vérifie et convertit le tableau associatif values 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 values a d'éléments. Les noms des champs de table_name doivent correspondre aux index du tableau dans values. Retourne un tableau avec les valeurs converties en cas de succès, et sinon, false.

Note:

Les valeurs booléennes sont acceptées et converties 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.

Liste de paramètres

connection
Une instance PgSql\Connection.
table_name

Nom de la table pour laquelle les types seront convertis.

values

Données à convertir.

flags

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 si une erreur survient.

Erreurs / Exceptions

Une ValueError ou TypeError est déclenchée lorsque la valeur ou le type du champ ne correspond pas correctement à un type PostgreSQL.

Historique

Version Description
8.3.0 Lance désormais une erreur ValueError ou TypeError lorsque la valeur ou le type du champ ne correspond pas correctement à un type PostgreSQL ; précédemment, un E_WARNING était émis.
8.1.0 Le paramètre connection attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

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

Voir aussi