pg_lo_create
(PHP 4 >= 4.2.0, PHP 5)
pg_lo_create — Cr�e un objet de grande taille PostgreSQL
Description
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");
?>