Crée un objet de grande taille PostgreSQL

# pg_lo_create

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

pg_lo_create — Crée un objet de grande taille PostgreSQL

### Description

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

pg_lo_create() crée un objet de grande taille et retourne son OID. Les modes d'accès PostgreSQL `INV_READ` et `INV_WRITE` ne sont pas supportés, l'objet est toujours créé avec des droits d'accès en lecture et écriture.

Pour utiliser un objet de grande taille, il est nécessaire de le faire dans une transaction.

Au lieu d'utiliser l'interface d'objet de grande taille (qui n'a aucun contrôle d'accès et qui est encombrant à utiliser), essayez la colonne de type bytea de PostgreSQL et pg_escape_bytea().

> Note:

> Auparavant, cette fonction s'appelait pg_locreate().

### Liste de paramètres

`connection`

  Une instance PgSql\Connection. Quand `connection` n'est pas spécifiée, la connexion par défaut est utilisée. La connexion par défaut est la dernière connexion faite par pg_connect() ou pg_pconnect()

  Avertissement

  À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.

`object_id`

  Si le paramètre `object_id` est fourni, la fonction essayera de créer un objet large avec cet identifiant, sinon, un identifiant d'objet disponible sera assigné par le serveur.

### Valeurs de retour

Un objet large OID, ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple avec 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, "données objet de grande taille");
       pg_lo_close($handle);
       pg_query($database, "commit");
    ?>

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