(PHP 4 >= 4.3.0, PHP 5)
pg_insert — Wstawia tablicę do tabeli
$identyfikator_połączenia
, string $nazwa_tabeli
, array $tablica_asocjacyjna
[, int $opcje
] )
pg_insert() wstawia wartości parametru tablica_asocjacyjna
do tabeli określonej przez parametr nazwa_tabeli.
Jeśli określono jakieś opcje,
funkcja pg_convert() stosuje
do parametru tablica_asocjacyjna określone opcje.
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, do której mają zostać dodane wiersze. Tabela nazwa_tabeli musi mieć
przynajmniej tyle kolumn, ile elementów ma tablica_asocjacyjna.
tablica_asocjacyjna
Tablica (ang. array), której klucze to nazwy pól w tabeli nazwa_tabeli,
oraz której wartościami są wartości tych pól, które mają zostać wpisane.
opcje
Dowolna kombinacja dowolnej ilości parametrów: PGSQL_CONV_OPTS,
PGSQL_DML_NO_CONV,
PGSQL_DML_EXEC,
PGSQL_DML_ASYNC oraz
PGSQL_DML_STRING. Gdy PGSQL_DML_STRING jest zawarty w parametrze
opcje, zwrócony zostanie łańcuch zapytania z URL (ang. query string).
Zwraca TRUE w przypadku powodzenia, FALSE w
przypadku błędu. Zwraca łańcuch (ang. string) jeśli PGSQL_DML_STRING zostało wprowadzone
poprzez parametr opcje.
Przykład #1 pg_insert() - przykład
<?php
$polaczenie_do_bazy = pg_connect ('dbname=foo');
// To wywołanie jest bezpieczne, odkąd $_POST jest konwertowane automatycznie
$res = pg_insert($polaczenie_do_bazy, 'kopia_post', $_POST);
if ($res) {
echo "Dane z tablicy POST zapisane pomyślnie\n";
} else {
echo "Użytkownik musiał wysłać złe dane\n";
}
?>