Werbung
pg_insert
(PHP 4 >= 4.3.0, PHP 5)
pg_insert — Überträgt Werte aus einem Array in eine Tabelle
Beschreibung
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.
Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere, was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes 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
2
3
4
5
6
7
8
$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";
}
Siehe auch
- pg_convert() - Konvertiert die Werte eines assoziativen Arrays in passende Werte für SQL-Kommandos.