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

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