PDO::pgsqlLOBCreate
Crée un nouvel objet large
&reftitle.description;
public stringPDO::pgsqlLOBCreate
PDO::pgsqlLOBCreate crée un objet large et retourne le
OID de cet objet. Vous devrez alors ouvrir un flux sur cet objet en
utilisant PDO::pgsqlLOBOpen pour lire et écrire des
données à l'intérieur. Le OID peut être enregistré en colonnes de type OID
et doit être utilisé pour référencer l'objet large, sans pour autant
augmenter arbitrairement la grandeur des lignes. L'objet large continuera a
vivre dans la base de données tant qu'il n'est pas supprimé en appelant
PDO::pgsqlLOBUnlink.
Les objets larges peuvent atteindre une taille jusqu'à 2GO, mais sont
encombrant à utiliser; vous devez vous assurer que
PDO::pgsqlLOBUnlink est appelée avant de supprimer la
dernière ligne qui fait référence son OID de votre base de données. De
plus, les objets larges n'ont pas de contrôle d'accès. Comme alternative,
essayez la colonne de type BYTEA; les nouvelles versions de PostgreSQL
autorisent les colonnes BYTEA à atteindre une taille de 1GO et gère de
manière transparente l'enregistrement pour avoir une ligne de taille
optimale.
Cette fonction doit être appelée à l'intérieur d'une transaction.
&reftitle.parameters;
PDO::pgsqlLOBCreate ne prend aucun paramètre.
&reftitle.returnvalues;
Retourne le OID du nouvel objet large créé en cas de réussite ou &false; en
cas d'échec.
&reftitle.examples;
Exemple avec <function>PDO::pgsqlLOBCreate</function>
Cet exemple crée un nouvel objet large et copie le contenu d'un fichier à
l'intérieur. Le OID est alors enregistré dans une table.
setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$db->beginTransaction();
$oid = $db->pgsqlLOBCreate();
$stream = $db->pgsqlLOBOpen($oid, 'w');
$local = fopen($filename, 'rb');
stream_copy_to_stream($local, $stream);
$local = null;
$stream = null;
$stmt = $db->prepare("INSERT INTO BLOBS (ident, oid) VALUES (?, ?)");
$stmt->execute(array($some_id, $oid));
$db->commit();
?>
]]>
&reftitle.seealso;
PDO::pgsqlLOBOpen
PDO::pgsqlLOBUnlink
pg_lo_create