Erzeugt ein Large Object

# pg_lo_create

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

pg_lo_create — Erzeugt ein Large Object

### Beschreibung

function pg_lo_create(PgSql\Connection `$connection` = ?, mixed `$object_id` = ?): int
function pg_lo_create(mixed `$object_id`): int

pg_lo_create() erzeugt ein Large Object und gibt dessen OID zurück. Die `INV_READ`- und `INV_WRITE`-Zugriffsmodi von PostgreSQL werden nicht unterstützt. Ein Large Object wird immer mit Lese- und Schreibzugriff erzeugt.

Um die Large Object (lo) Schnittstelle benutzen zu können, müssen die Kommandos innerhalb einer Transaktion ausgeführt werden.

Anstelle der Large-Object-Schnittstelle (für die es keine Zugriffssteuerung gibt und deren Benutzung etwas schwerfällig ist) können Sie den PostgreSQL-Datentyp bytea und die Funktion pg_escape_bytea() benutzen.

> Hinweis:

> Diese Funktion ersetzt die Funktion pg_locreate().

### Parameter-Liste

`connection`

  Eine PgSql\Connection-Instanz. Falls `connection` nicht angegeben wurde, wird die Standardverbindung benutzt. Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.

  Warnung

  Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.

`object_id`

  Wenn es einen Parameter `object_id` gibt, wird diese Funktion versuchen, ein Large Object mit dieser ID zu erzeugen. Anderenfalls wird dem Large Object vom Server eine freie ID zugewiesen.

### Rückgabewerte

Ein Large Object OID. Bei einem Fehler wird `false` zurückgegeben.

### Changelog

Version | Beschreibung
--- | ---
8.1.0 | Der Parameter `connection` erwartet nun eine PgSql\Connection-Instanz; vorher wurde eine Ressource erwartet.

### Beispiele

Beispiel #1 pg_lo_create()-Beispiel

    <?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, "Daten fuer das Large Object");
     pg_lo_close($handle);
     pg_query($database, "commit");
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open