PHP Handbuch
ZurückWeiter

pg_query

(PHP 4 >= 4.2.0, PHP 5)

pg_query -- Führt eine Abfrage aus

Beschreibung

resource pg_query ( string query )

resource pg_query ( resource connection, string query )

pg_query() führt die query auf der angegebenen connection aus.

Falls ein Fehler auftritt und FALSE zurückgegeben wird, können Sie diesen mit pg_last_error() anzeigen, vorausgesetzt, die Verbindungskennung ist gültig.

Anmerkung: Obwohl der Parameter connection weggelassen kann, ist dies nicht empfehlenswert, da es die Fehlersuche in Skripten erschweren kann.

Anmerkung: 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 Verbindungkennung. 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

Beispiel 1. pg_query() Beispiel

<?php

$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";
}

?>

Beispiel 2. pg_query() mit mehreren Anweisungen

<?php

$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()
pg_pconnect()
pg_fetch_array()
pg_fetch_object()
pg_num_rows()
pg_affected_rows()

ZurückZum AnfangWeiter
pg_query_paramsNach obenpg_result_error_field