(PHP 4 >= 4.2.0, PHP 5)
pg_lo_import — Importuje wielki obiekt (Large Object - LO) z pliku
pg_lo_import() kreuje nowy Wielki Obiekt (LO) w bazie danych, używając pliku w systemie plików jako jego danych źródłowych.
Użycie interfejsu wielkich obiektów (LO) wymaga zamknięcia wszystkich operacji z nim związanych wewnątrz transakcji.
Informacja: Gdy włączony jest tryb bezpieczny, PHP sprawdza, czy pliki lub katalogi, na których zostaną wykonane operacje mają takie same UID (owner) jak skrypt, który jest aktualnie wykonywany.
Informacja:
Ta funkcja była poprzednio nazwana pg_loimport().
polaczenie
Identyfikator połączenia do bazy PostgreSQL. Gdy parametr
polaczenie nie został podany, zostanie użyte
domyślne połączenie. Domyślnym połączeniem jest ostatnie połączenie stworzone przez
pg_connect() lub pg_pconnect().
sciezka
Pełna ścieżka z nazwą pliku znajdującego się w systemie plików klienta, z którego zostanie przeczytany LO.
id_obiektu
Jeśli id_obiektu został podany, funkcja
spróbuje stworzyć wielki obiekt o podanym unikalnym identyfikatorze, w przeciwnym razie
serwer przydzieli dowolne id. Parametr został
dodany w PHP 5.3 i jest uzależniony od mechanizmów działania, które jako pierwsze
pojawiły się w PostgreSQL 8.1.
Identyfikator OID nowo stworzonego LO, lub
FALSE w przypadku błędów.
| Wersja | Opis |
|---|---|
| 4.2.0 | Składnia tej funkcji uległa zmianie. Wcześniej wyglądała tak:
int pg_lo_import
( string
$sciezka
[, resource $polaczenie
] ) |
Przykład #1 pg_lo_import() - przykład
<?php
$baza_danych = pg_connect("dbname=warszawa");
pg_query($baza_danych, "begin");
$oid = pg_lo_import($baza_danych, '/tmp/lob.dat');
pg_query($baza_danych, "commit");
?>