pg_lo_export
pg_lo_open
Funkcje PostgreSQL
PHP Manual

# pg_lo_import

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_import — Importuje wielki obiekt (Large Object - LO) z pliku

### Opis

int pg_lo_import ( resource `$polaczenie` , string `$sciezka` , mixed `$id_objektu` )
int pg_lo_import ( string `$sciezka` , mixed `$id_objektu` )

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 `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.

### 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)

pg_lo_export
pg_lo_open
Funkcje PostgreSQL
PHP Manual