Импорт большого объекта из файла

Описание

int pg_lo_import ([ resource $connection ], string $pathname [, mixed $object_id ] )

pg_lo_import() создает большой объект в базе данных, используя локальный файл в качестве источника данных.

Операции с использованием интерфейса больших объектов необходимо заключать в блок транзакции.

Замечание: Когда опция safe mode включена, PHP проверяет, имеют ли файлы/каталоги, с которыми вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.

Замечание:
Прежнее название функции: pg_loimport().

Список параметров

connection: Ресурс подключения к базе данных PostgreSQL. Если параметр connection не задан, будет использовано подключение по умолчанию - последнее соединение, открытое функцией pg_connect() или pg_pconnect().
pathname: Полный путь и имя файла в клиентской файловой системе для чтения данных большого объекта.
object_id: Если задан аргумент object_id, функция попытается создать объект с этим идентификатором, в противном случае будет использован свободный идентификатор, назначенный сервером. Этот аргумент появился в PHP 5.3 и основан на функционале, впервые реализованном в PostgreSQL 8.1.

Возвращаемые значения

OID созданного большого объекта, либо FALSE в случае ошибки.

Список изменений

Версия Описание

5.3.0

Добавлен необязательный аргумент object_id.

4.2.0

Определение функции изменено. Прежнее определение:

int pg_lo_import ( string $pathname [, resource $connection ] )

Примеры

Пример #1 Пример использования pg_lo_import()


<?php
   $database = pg_connect("dbname=jacarta");
   pg_query($database, "begin");
   $oid = pg_lo_import($database, '/tmp/lob.dat');
   pg_query($database, "commit");
?>

Смотрите также

pg_lo_export() - Вывод большого объекта в файл
pg_lo_open() - Открывает большой объект базы данных