Feeds: Artikel; Kommentare

PHP Dokumentation: Function pg-insert

12. Januar 2010 von werner

pg_insert

(PHP 4 >= 4.3.0, PHP 5)

pg_insert — Überträgt Werte aus einem Array in eine Tabelle

Beschreibung

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

pg_insert() fügt die Werte des assoc_array in die Tabelle table_name ein. Falls options angegeben wurde, wird pg_insert() auf assoc_array mit den angegebenen Optionnen angewendet.

Warnung

Diese Funktion istEXPERIMENTELL. Das Verhalten, der Funktionsname und allesAndere, was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohneAnkündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion aufeigenes Risiko.

Parameter-Liste

connection: PostgreSQL Verbindungskennung.
table_name: Name der Tabelle, in die die Zeilen eingefügt werden sollen. table_name muss mindestens soviele Spalten haben, wie das assoc_array Elemente.
assoc_array: Ein array dessen Indizes Feldnamen von table_name sind und dessen Werte in die entprechenden Spalten eingefügt werden.
options: Jede Kombination aus PGSQL_CONV_OPTS, PGSQL_DML_NO_CONV, PGSQL_DML_EXEC, PGSQL_DML_ASYNC oder PGSQL_DML_STRING. Falls PGSQL_DML_STRING bei den options angegeben wurde, wird der Abfrage-String zurückgegeben.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Falls die Konstante PGSQL_DML_STRING in den options übergeben wurde, wird ein string zurückgegeben.

Beispiele

Beispiel #1 pg_insert() Beispiel

<?php
  $dbconn = pg_connect('dbname=foo');
  // Das ist sicher, da $_POST automatisch konvertiert wird
  $res = pg_insert($dbconn, 'post_log', $_POST);
  if ($res) {
      echo "Der Inhalt von $_POST wurde protokolliert\n";
  } else {
      echo "Vermutlich wurden falsche Eingabedaten gesendet\n";
  }
?>