pg_convert

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

    pg_convert — Convertit des valeurs d'un tableaux associatifs 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 convertie 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 sur pour laquelle les types seront convertis.

    values

    Données à être converties.

    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

    VersionDescription
    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 ressource é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

    To Top