pg_lo_create

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_create Cr�e un objet de grande taille PostgreSQL

Description

int pg_lo_create ([ resource $connection [, mixed $object_id ]] )
int pg_lo_create ( mixed $object_id )

pg_lo_create() cr�e un objet de grande taille et retourne son OID. Les modes d'acc�s PostgreSQL INV_READ, INV_WRITE et INV_ARCHIVE ne sont pas support�s : l'objet peut toujours �tre cr�� avec des droits d'acc�s en lecture et �criture. Le mode INV_ARCHIVE a �t� supprim� des bases PostgreSQL (version 6.3 et ult�rieur).

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

La ressource de connexion de la base de donn�es PostgreSQL. Lorsque connection n'est pas pr�sent, 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().

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. Ce param�tre a �t� ajout� en PHP 5.3 et cette fonctionnalit� est apparue avec PostgreSQL 8.1.

Valeurs de retour

Un objet large OID ou FALSE en cas d'erreur.

Historique

Version Description
5.3.0

Le param�tre optionnel object_id a �t� ajout�.

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");
?>