pg_delete
(PHP 4 >= 4.3.0, PHP 5)
pg_delete — Lscht Datenstze
Beschreibung
$connection
, string $table_name
, array $assoc_array
[, int $options = PGSQL_DML_EXEC
] )
pg_delete() löscht Datensätze aus table_name,
deren Feldnamen den Indizes von assoc_array
entsprechen und deren Spaltenwerte mit den Werten der Arrayelemente identisch sind. Falls
options angegeben wurde, wird pg_convert() mit
den angegebenen Optionen auf assoc_array angewendet.
Parameter-Liste
-
connection -
PostgreSQL Verbindungskennung.
-
table_name -
Name der Tabelle, aus der Zeilen gelöscht werden.
-
assoc_array -
Ein array dessen Schlüssel den Feldnamen der Tabelle
table_nameentsprechen und dessen Werte den zu löschenden Spaltenwerten entsprechen. -
options -
Jede Kombination aus
PGSQL_CONV_FORCE_NULL,PGSQL_DML_NO_CONV,PGSQL_DML_ESCAPE,PGSQL_DML_EXEC,PGSQL_DML_ASYNCoderPGSQL_DML_STRING. FallsPGSQL_DML_STRINGin denoptionsenthalten ist, wird der Abfragestring zurückgegeben. WerdenPGSQL_DML_NO_CONVoderPGSQL_DML_ESCAPEangegeben, wird pg_convert() intern nicht aufgerufen.
Rückgabewerte
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Gibt einen string zurück, falls
die Konstante PGSQL_DML_STRING im Parameter
options übergeben wurde.
Beispiele
Beispiel #1 pg_delete() Beispiel
<?php
$db = pg_connect('dbname=foo');
// Das ist sicher, weil $_POST automatisch konvertiert wird
$res = pg_delete($db, 'post_log', $_POST);
if ($res) {
echo "POST-Daten wurden gelscht: $res\n";
} else {
echo "Aufruf erfolgte mit falschen Angaben\n";
}
?>
Changelog
| Version | Beschreibung |
|---|---|
| 5.6.0 |
Nicht länger experimentell. Die PGSQL_DML_ESCAPE
Konstante wurde hinzugefügt, wie auch Unterstützung für TRUE/FALSE
und NULL Datentypen.
|
| 5.5.3/5.4.19 |
Direkte SQL-Injection in table_name und indirekte
SQL-Injection in Bezeichner wurden behoben.
|
Siehe auch
- pg_convert() - Konvertiert die Werte eines assoziativen Arrays in passende Werte für SQL-Kommandos.