pg_lo_import

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_import Importe un objet de grande taille depuis un fichier

Description

int pg_lo_import ([ resource $connection ], string $pathname , mixed $object_id )

pg_lo_import() cr�e un nouvel objet de grande taille dans la base de donn�es en utilisant un fichier dans le syst�me de fichier en tant que donn�es sources.

Pour utiliser un objet de grande taille (lo), il est n�cessaire de le faire dans une transaction.

Note: Lorsque le safe-mode est activ�, PHP v�rifie si le fichier/dossier que vous allez utiliser a le m�me UID que le script qui est actuellement ex�cut�.

Note: Auparavant, cette fonction s'appelait pg_loimport().

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().

pathname

Le chemin d'acc�s complet ainsi que le fichier dans lequel il sera lu l'objet de grande taille sur le syst�me du client.

object_id

Si le param�tre object_id est fourni, la fonction essayera de cr�er un objet large avec cette 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

Le OID du nouvel objet de grande taille cr�� ou FALSE en cas d'�chec.

Historique

Version Description
5.3.0

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

4.2.0

La syntaxe de cette fonction a chang�. Avant PHP 4.2.0, la syntaxe �tait :

int pg_lo_import ( string $pathname [, resource $connection ] )

Exemples

Exemple #1 Exemple avec pg_lo_import()

<?php
   $database 
pg_connect("dbname=jacarta");
   
pg_query($database"begin");
   
$oid pg_lo_import($database'/tmp/lob.dat');
   
pg_query($database"commit");
?>

Voir aussi