Werbung
pg_query
(PHP 4 >= 4.2.0, PHP 5)
pg_query — Führt eine Abfrage aus
Beschreibung
pg_query() führt die query auf der angegebenen Datenbank-connection aus.
Falls ein Fehler auftritt und FALSE zurückgegeben wird, können Sie Details zu diesem Fehler mit pg_last_error() anzeigen, vorausgesetzt, die Verbindungskennung ist gültig.
Hinweis: Obwohl der Parameter connection weggelassen werden kann, ist dies nicht empfehlenswert, da es die Fehlersuche in Skripten erschweren kann.
Hinweis: Diese Funktion ersetzt die Funktion pg_exec(). pg_exec() wird aus Gründen der Kompatibilität immer noch unterstützt, es wird jedoch empfohlen, den neuen Funktionsnamen zu verwenden.
Parameter-Liste
- connection
-
PostgreSQL Verbindungskennung. Falls connection nicht angegeben wurde, wird die zuletzt mit pg_connect() oder pg_pconnect() geöffnete Verbindung benutzt.
- query
-
Die auszuführende(n) SQL-Anweisung(en). Werden mehrere Anweisungen an pg_query() übergeben, werden sie automatisch in einer einzigen Transaktion ausgeführt, es sei denn, die Anweisungsfolge enthält explizite BEGIN/COMMIT Anweisungen. Von der Ausführung mehrerer Transaktionen innerhalb eines Funktionsaufrufs wird abgeraten.
Rückgabewerte
Bei Erfolg wird eine Ergebniskennung für die Abfrage zurückgegeben, anderenfalls FALSE.
Beispiele
2
3
4
5
6
7
8
9
10
11
12
13
14
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
while ($row = pg_fetch_row($result)) {
echo "Autor: $row[0] E-Mail: $row[1]";
echo "<br />\n";
}
2
3
4
5
6
$conn = pg_pconnect("dbname=publisher");
// diese Anweisungen werden in einer einzigen Transaktion ausgeführt.
$query = "UPDATE authors SET author=UPPER(author) WHERE id=1;";
$query .= "UPDATE authors SET author=LOWER(author) WHERE id=2;";
$query .= "UPDATE authors SET author=NULL WHERE id=3;";
pg_query($conn, $query);
Siehe auch
- pg_connect() - Öffnet eine PostgreSQL-Verbindung
- pg_pconnect() - Öffnet eine persistente PostgreSQL-Verbindung
- pg_fetch_array() - Holt eine Zeile als Array
- pg_fetch_object() - Holt einen Datensatz als Objekt
- pg_num_rows() - Gibt die Anzahl der Zeilen in einem Abfrageergebnis zurück
- pg_affected_rows() - Gibt die Anzahl betroffener Datensätze (Tupel) zurück