pg_lo_create
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_create — Створює великий об'єкт
Опис
pg_lo_create(PgSql\Connection $connection = ?, mixed $object_id = ?): int
pg_lo_create(mixed $object_id): int
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()****