pg_lo_import

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

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

Описание

pg_lo_import(PgSql\Connection $connection = ?, string $pathname, mixed $object_id = ?): int|string|false

Функция pg_lo_import() создаёт большой объект в базе данных из локального файла.

Методы интерфейса больших объектов работают только внутри блока транзакций.

Замечание:

Раньше функция называлась pg_loimport().

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

connection

Экземпляр класса PgSql\Connection. Функция выберет соединение по умолчанию, если параметр connection не указали. Соединение по умолчанию — последнее соединение, которое установила функция pg_connect() или pg_pconnect().

Внимание

Начиная с PHP 8.1.0 выбор функцией соединения по умолчанию устарел.

pathname

Полный путь и название файла в клиентской файловой системе, из которого функция считает данные большого объекта.

object_id

При установке параметра object_id функция попытается создать объект с этим идентификатором, иначе сервер назначит объекту свободный идентификатор. Параметр работает на основе механизма, который впервые появился в PostgreSQL 8.1.

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

Функция возвращает OID вновь созданного большого объекта или false, если возникла ошибка.

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

Версия Описание
8.1.0 Параметр connection теперь ожидает экземпляр класса PgSql\Connection; раньше параметр ожидал ресурс (resource).

Примеры

Пример #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() - Открывает большой объект базы данных