pg_insert
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_insert — Überträgt Werte aus einem Array in eine Tabelle
Beschreibung
Falls flags
angegeben wurde, wird
pg_convert() mit den angegebenen Flags auf das Array
values
angewendet.
Standardmäßig übergibt pg_insert() Rohwerte. Die Werte
müssen entweder maskiert werden oder es muss die Option PGSQL_DML_ESCAPE
angegeben werden. PGSQL_DML_ESCAPE
maskiert Parameter und Bezeichner und
setzt sie in Anführungszeichen. Daher muss bei Tabellen- und Spaltennamen
zwischen Groß- und Kleinschreibung unterschieden werden.
Es ist zu beachten, dass weder die Maskierung noch eine vorbereitete
Abfrage LIKE-Abfragen, JSON, Array, Regex usw. schützen können. Diese
Parameter sollten im Kontext behandelt werden, d. h. Werte maskieren und
validieren.
Parameter-Liste
connection
-
Eine PgSql\Connection-Instanz.
table_name
-
Der Name der Tabelle, in die die Zeilen eingefügt werden sollen.
table_name
muss mindestens soviele Spalten
haben, wie das values
Elemente.
values
-
Ein array, dessen Indizes die Feldnamen der Tabelle
table_name
sind und dessen Werte die Werte sind,
die in die entprechenden Spalten eingefügt werden sollen.
flags
-
Jede Kombination aus PGSQL_CONV_OPTS
,
PGSQL_DML_NO_CONV
,
PGSQL_DML_ESCAPE
,
PGSQL_DML_EXEC
,
PGSQL_DML_ASYNC
und
PGSQL_DML_STRING
. Falls
PGSQL_DML_STRING
bei den
flags
angegeben wurde, wird der Abfrage-String
zurückgegeben. Werden PGSQL_DML_NO_CONV
oder
PGSQL_DML_ESCAPE
angegeben, wird
pg_convert() intern nicht aufgerufen.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.. Oder gibt bei Erfolg einen String zurück, wenn
PGSQL_DML_STRING
über flags
übergeben wird.
Fehler/Exceptions
Wenn die angegebene Tabelle ungültig ist, wird ein
ValueError geworfen.
Wenn der Wert oder der Typ eines Feldes nicht mit einem PostgreSQL-Typ
übereinstimmt, wird ein ValueError oder
TypeError geworfen.
Beispiele
Beispiel #1 pg_insert()-Beispiel
<?php
$dbconn = pg_connect('dbname=foo');
// Das ist einigermaßen sicher, da alle Werte maskiert werden.
// Allerdings unterstützt PostgreSQL JSON/Array. Diese sind nicht
// sicher, da sie Abfragen weder maskieren noch vorbereiten.
$res = pg_insert($dbconn, 'post_log', $_POST, PGSQL_DML_ESCAPE);
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 die für SQL-Anweisungen
passende Form