(PHP 4 >= 4.2.0, PHP 5)
pg_query — Realizujezapytanie do bazy danych
pg_query() wykonuje zapytanie na określonej parametrem identyfikator_połączenia bazie danych.
Jeśli nadarzy się błąd, oraz zwracane jest FALSE, jego szczegóły mogą zostać wydobyte dzięki użyciu funkcji pg_last_error(), jeśli połączenie jest poprawne.
Informacja: Chociaż identyfikator_połączenia można pominąć, nie jest to zalecane, gdyż może to powodować trudne do znalezienia błędy w skrypcie.
Informacja:
Ta funkcja była poprzednio nazwana pg_exec(). pg_exec() jest wciąż dostępna w celu zachowania kompatybilności, ale zalecane jest używanie nowej nazwy.
Identyfikator połączenia do bazy PostgreSQL. Jeśli identyfikator_połączenia nie został podany, zostanie użyte domyślne połączenie. Domyślnym połączeniem jest to, które jako ostatnie zostało stworzone przez jedną z funkcji: pg_connect() lub pg_pconnect().
Polecenie lub polecenia SQL, do wykonania. Kiedy do funkcji podane zostanie więcej jak jedno zapytanie, wykonają się one automatycznie jako jedna operacja, chyba, że komendy BEGIN/COMMIT są zawarte w zapytaniu. Niemniej jednak, używanie wielu operacji w jednym wywołaniu funkcji nie jest zalecane.
Identyfikator wyniku zapytania w przypadku sukcesu, lub FALSE w przypadku niepowodzenia.
Przykład #1 pg_query() - przykład
<?php
$polaczenie = pg_pconnect("dbname=publisher");
if (!$polaczenie) {
echo "Wystąpił błąd.\n";
exit;
}
$wynik = pg_query($polaczenie, "SELECT autor, email FROM autorzy");
if (!$wynik) {
echo "Wystąpił błąd.\n";
exit;
}
while ($wiersz = pg_fetch_row($wynik)) {
echo "Autor: $wiersz[0] E-mail: $wiersz[1]";
echo "<br />\n";
}
?>
Przykład #2 Używanie pg_query() z wieloma zapytaniami
<?php
$polaczenie = pg_pconnect("dbname=wydawca");
// te polecenia wykonają się jako jedna operacja
$zapytanie = "UPDATE autorzy SET autor=UPPER(autor) WHERE id=1;";
$zapytanie .= "UPDATE autorzy SET autor=LOWER(autor) WHERE id=2;";
$zapytanie .= "UPDATE autorzy SET autor=NULL WHERE id=3;";
pg_query($polaczenie, $zapytanie);
?>