(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_create — Создаёт большой объект
pg_lo_create() создаёт большой объект
и возвращает его OID. Режимы доступа
PostgreSQL INV_READ
, INV_WRITE
,
и INV_ARCHIVE
не поддерживаются, объект всегда
создаётся с доступом на чтение и запись. Режим INV_ARCHIVE
убран из PostgreSQL версий 6.3 и выше.
Операции с использованием интерфейса больших объектов необходимо заключать в блок транзакции.
Вместо использования интерфейса больших объектов (который не имеет контроля доступа и весьма громоздкий сам по себе) пользуйтесь полями PostgreSQL типа bytea для хранения двоичных данных и функцией pg_escape_bytea() для их экранирования.
Замечание:
Прежнее название функции: pg_locreate().
connection
Экземпляр PgSql\Connection.
Если connection
не указано, используется соединение по умолчанию. Соединение по умолчанию - это последнее соединение, выполненное с помощью функций pg_connect()
или pg_pconnect().
Начиная с версии PHP 8.1.0, использование соединения по умолчанию устарело.
object_id
Если задан аргумент object_id
, функция
попытается создать объект с этим идентификатором, в противном
случае будет использован свободный идентификатор, назначенный
сервером. Этот аргумент основан на функционале,
впервые реализованном в PostgreSQL 8.1.
OID большого объекта или false
в случае возникновения ошибки.
Версия | Описание |
---|---|
8.1.0 |
Параметр connection теперь ожидает экземпляр PgSql\Connection; ранее ожидался ресурс (resource).
|
Пример #1 Пример использования pg_lo_create()
<?php
$database = pg_connect("dbname=jacarta");
pg_query($database, "begin");
$oid = pg_lo_create($database);
echo "$oid\n";
$handle = pg_lo_open($database, $oid, "w");
echo "$handle\n";
pg_lo_write($handle, "large object data");
pg_lo_close($handle);
pg_query($database, "commit");
?>