pg_insert

(PHP 4 >= 4.3.0, PHP 5)

pg_insert Ins�re un tableau dans une table

Description

mixed pg_insert ( resource $connection , string $table_name , array $assoc_array [, int $options= PGSQL_DML_EXEC ] )

pg_insert() ins�re le tableau assoc_array dans la table table_name . Si options est sp�cifi�e, pg_convert() s'applique � assoc_array avec l'option sp�cifi�e.

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concr�tement, TOUT ce qui est document� ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction � vos risques et p�rils.

Liste de param�tres

connection

Une ressource de connexion PostgreSQL.

table_name

Nom de la table dans laquelle les lignes seront ins�r�es. La table table_name doit avoir au moins autant de colonnes que assoc_array a d'�l�ments.

assoc_array

Un tableau dont les cl�s sont les noms des champs dans la table table_name , et o� les valeurs sont les valeurs de ces champs qui seront ins�r�s.

options

Toutes combinaisons de constantes parmi PGSQL_CONV_OPTS, PGSQL_DML_NO_CONV, PGSQL_DML_EXEC, PGSQL_DML_ASYNC ou PGSQL_DML_STRING. Si PGSQL_DML_STRING fait partie du param�tre options , alors la requ�te sera retourn�e.

Valeurs de retour

Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec. Retourne une cha�ne de caract�res si PGSQL_DML_STRING est pass� via le param�tre options .

Exemples

Exemple #1 Exemple avec pg_insert()

<?php 
  $db 
pg_connect ('dbname=foo');
  
// C'est s�curitaire, car $_POST est convertit automatiquement
  
$res pg_insert($db'post_log'$_POST);
  if (
$res) {
      echo 
"Les donn�es POST�es ont pu �tre enregistr�es avec succ�s.\n";
  } else {
      echo 
"Il y a un probl�me avec les donn�es.\n";
  }
?>

Voir aussi

  • pg_convert() - Convertit des tableaux associatifs en une commande PostgreSQL