(PHP 4 >= 4.3.0, PHP 5)
pg_update — Aktualizuje tabelę
$identyfikator_połączenia
, string $nazwa_tabeli
, array $dane
, array $warunek
[, int $opcje
] )pg_update() aktualizuje wiersze spełniające warunki zawarte w parametrze warunek używając danych z parametru dane. Jeśli jest użyty parametr opcje, jest on przekazywany do wywołania pg_convert() z opcjami w parametrze dane.
Ta funkcja jest w stadium EKSPERYMENTALNYM. Oznacza to, że zachowanie funkcji, jej nazwa, w zasadzie wszystko udokumentowane tutaj może zostać zmienione w przyszłych wersjach PHP bez wcześniejszego uprzedzenia. Używaj tej funkcji na własne ryzyko.
identyfikator_połączenia
Identyfikator połączenia do bazy PostgreSQL.
nazwa_tabeli
Nazwa tabeli, w której będą aktualizowane wiersze.
dane
Tablica (ang. array), której klucze są nazwami kolumn w tabeli nazwa_tabeli,
oraz której wartości są nową zawartością pasujących do warunków wierszy.
warunek
Tablica (ang. array), której klucze są nazwami kolumn w tabeli nazwa_tabeli,
oraz której wartości są warunkami, jakie muszą spełnić uaktualniane wiersze.
opcje
Dowolna kombinacja dowolnej ilości parametrów: PGSQL_CONV_OPTS,
PGSQL_DML_NO_CONV,
PGSQL_DML_EXEC oraz
PGSQL_DML_STRING. Jeśli PGSQL_DML_STRING został podany w parametrze
opcje, zostanie zwrócony łańcuch zapytania.
Zwraca TRUE w przypadku powodzenia, FALSE w
przypadku błędu. Zwraca łańcuch (ang. string) gdy PGSQL_DML_STRING został podany
poprzez opcje.
Przykład #1 pg_update() - przykład
<?php
$polaczenie = pg_connect ('dbname=foo');
$dane = array('kolumna1'=>'AA', 'kolumna2'=>'BB');
// To jest bezpieczne, gdyż $_POST jest konwertowane automatycznie
$res = pg_update($polaczenie, 'kopia_post', $_POST, $dane);
if ($res) {
echo "Dane zostały zaktualizowane: $res\n";
} else {
echo "Użytkownik wprowadził błędne dane\n";
}
?>