cvs: phpdoc-fr /reference/pdo_pgsql/functions PDO-pgsqlLOBCreate.xml PDO-pgsqlLOBOpen.xml PDO-pgsqlLOBUnlink.xml

From: Date: Sun, 04 Dec 2005 08:45:48 +0000
Subject: cvs: phpdoc-fr /reference/pdo_pgsql/functions PDO-pgsqlLOBCreate.xml PDO-pgsqlLOBOpen.xml PDO-pgsqlLOBUnlink.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-4671@lists.php.net to get a copy of this message
jsgoupil Sun Dec 4 03:45:48 2005 EDT Added files: /phpdoc-fr/reference/pdo_pgsql/functions PDO-pgsqlLOBCreate.xml PDO-pgsqlLOBOpen.xml PDO-pgsqlLOBUnlink.xml Log: Initial Translation

http://cvs.php.net/co.php/phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBCreate.xml?r=1.1&p=1 Index: phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBCreate.xml +++ phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBCreate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: no --> <refentry id="function.PDO-pgsqlLOBCreate"> <refnamediv> <refname>PDO::pgsqlLOBCreate</refname> <refpurpose>Crée un nouvel objet large</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>PDO::pgsqlLOBCreate</methodname> <void/> </methodsynopsis> <para> <function>PDO::pgsqlLOBCreate</function> crée un objet large et retourne le OID de cet objet. Vous devrez alors ouvrir un flux sur cet objet en utilisant <function>PDO::pgsqlLOBOpen</function> 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 <function>PDO::pgsqlLOBUnlink</function>. </para> <para> Les objets larges peuvent atteindre une taille jusqu'à 2GO, mais sont encombrant à utiliser; vous devez vous assurer que <function>PDO::pgsqlLOBUnlink</function> 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. </para> <note> <simpara> Cette fonction doit être appelée à l'intérieur d'une transaction. </simpara> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <function>PDO::pgsqlLOBCreate</function> ne prend aucun paramètre. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne le OID du nouvel objet large créé en cas de réussite ou &false; en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>PDO::pgsqlLOBCreate</function></title> <para> 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. </para> <programlisting role="php"> <![CDATA[ <?php $db = new PDO('pgsql:dbname=test host=localhost', $user, $pass); $db->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(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PDO::pgsqlLOBOpen</function></member> <member><function>PDO::pgsqlLOBUnlink</function></member> <member><function>pg_lo_create</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBOpen.xml?r=1.1&p=1 Index: phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBOpen.xml +++ phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBOpen.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: no --> <refentry id="function.PDO-pgsqlLOBOpen"> <refnamediv> <refname>PDO::pgsqlLOBOpen</refname> <refpurpose>Ouvre un flux existant de large objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>PDO::pgsqlLOBOpen</methodname> <methodparam><type>string</type><parameter>oid</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> <function>PDO::pgsqlLOBOpen</function> ouvre un flux pour accéder aux données référencées par <parameter>oid</parameter>. Si <parameter>mode</parameter> est <literal>r</literal>, le flux est ouvert en lecture, si <parameter>mode</parameter> est <literal>w</literal>, alors le flux sera ouvert en écriture. Vous pouvez utilisez toutes les fonctions usuelles de système de fichiers, comme <function>fread</function>, <function>fwrite</function> et <function>fgets</function> pour manipuler le contenu du flux. </para> <note> <simpara> Cette fonction, ainsi que toutes les manipulations sur l'objet large, doit être appelée et exécutée à l'intérieur d'une transaction. </simpara> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>oid</parameter></term> <listitem> <para> Un identifiant d'objet large </para> </listitem> </varlistentry> <varlistentry> <term><parameter>mode</parameter></term> <listitem> <para> Si le mode est <literal>r</literal>, ouverture du flux en lecture. Si le mode est <literal>w</literal>, ouverture du flux en écriture. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une ressource de flux en cas de succès ou &false; en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>PDO::pgsqlLOBOpen</function></title> <para> Suivant l'exemple de <function>PDO::pgsqlLOBCreate</function>, cet partie de code récupère l'objet large de la base de données et l'affiche au navigateur. </para> <programlisting role="php"> <![CDATA[ <?php $db = new PDO('pgsql:dbname=test host=localhost', $user, $pass); $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $db->beginTransaction(); $stmt = $db->prepare("select oid from BLOBS where ident = ?"); $stmt->execute(array($some_id)); $stmt->bindColumn('oid', $lob, PDO::PARAM_LOB); $stmt->fetch(PDO::FETCH_BOUND); fpassthru($lob); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PDO::pgsqlLOBCreate</function></member> <member><function>PDO::pgsqlLOBUnlink</function></member> <member><function>pg_lo_open</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBUnlink.xml?r=1.1&p=1 Index: phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBUnlink.xml +++ phpdoc-fr/reference/pdo_pgsql/functions/PDO-pgsqlLOBUnlink.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: no --> <refentry id="function.PDO-pgsqlLOBUnlink"> <refnamediv> <refname>PDO::pgsqlLOBUnlink</refname> <refpurpose>Supprime un objet large</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PDO::pgsqlLOBUnlink</methodname> <methodparam><type>string</type><parameter>oid</parameter></methodparam> </methodsynopsis> <para> Supprime un large objet de la base de données identifié par le OID. </para> <note> <simpara> Cette fonction doit être appelée à l'intérieur d'une transaction. </simpara> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>oid</parameter></term> <listitem> <para> Un identifiant d'objet large </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <function>PDO::pgsqlLOBUnlink</function></title> <para> Cet exemple supprime l'objet large de la base de données avant de supprimer la ligne qui le référence de la table binaire que nous avons utilisé dans nos exemples de <function>PDO::pgsqlLOBCreate</function> et <function>PDO::pgsqlLOBOpen</function>. </para> <programlisting role="php"> <![CDATA[ <?php $db = new PDO('pgsql:dbname=test host=localhost', $user, $pass); $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $db->beginTransaction(); $db->pgsqlLOBUnlink($oid); $stmt = $db->prepare("DELETE FROM BLOBS where ident = ?"); $stmt->execute(array($some_id)); $db->commit(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PDO::pgsqlLOBOpen</function></member> <member><function>PDO::pgsqlLOBCreate</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.fr (#4671) next »