pg_lo_import
(PHP 4 >= 4.2.0, PHP 5)
pg_lo_import — Importuje wielki obiekt (Large Object - LO) z pliku
Opis
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().
Parametry
-
polaczenie -
Identyfikator połączenia do bazy PostgreSQL. Gdy parametr
polaczenienie 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_obiektuzostał 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.
Zwracane wartości
Identyfikator OID nowo stworzonego LO, lub
FALSE w przypadku błędów.
Rejestr zmian
| 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łady
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");
?>
Zobacz też:
- pg_lo_export() - Eksportuje wielki obiekt (Large Object - LO) do pliku
- pg_lo_open() - Otwiera wielki obiekt (Large Object - LO)
