cvs: phpdoc /fr/functions pgsql.xml
| From: | Damien Seguy | Date: | Thu, 01 Nov 2001 16:31:16 +0000 |
| Subject: | cvs: phpdoc /fr/functions pgsql.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338418@lists.php.net to get a copy of this message | ||
dams Thu Nov 1 11:31:16 2001 EDT
Modified files:
/phpdoc/fr/functions pgsql.xml
Log:
Adding xml stuff.Adding lastest updates.Correcting minor typos.
Index: phpdoc/fr/functions/pgsql.xml diff -u phpdoc/fr/functions/pgsql.xml:1.12 phpdoc/fr/functions/pgsql.xml:1.13 --- phpdoc/fr/functions/pgsql.xml:1.12 Sat Jul 7 18:22:20 2001 +++ phpdoc/fr/functions/pgsql.xml Thu Nov 1 11:31:16 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.13 $ --> <reference id="ref.pgsql"> <title>PostgreSQL</title> <titleabbrev>PostgreSQL</titleabbrev> @@ -12,8 +14,8 @@ il est Open Source et dans le domaine public. </para> <para> - PostgreSQL est disponible sans frais. La version actuelle est disponible à - (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>. + PostgreSQL est disponible sans frais. La version actuelle est disponible + à (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>. </para> <para> Depuis la version 6.3 (03/02/1998) PostgreSQL utilise les sockets UNIX, et @@ -71,30 +73,32 @@ </para> <para> L'ancienne syntaxe : - <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> + <command> + $conn = pg_connect("host", "port", "options", "tty", "dbname") + </command> est obsolète. </para> <para> - Pour utiliser l'interface des grands objets (large object (lo) interface), il - est nécessaire de les placer dans un bloc de transaction. Un bloc de - transaction commence avec <command>begin</command> et si la transaction se - termine avec un <command>commit</command> et <command>end</command>. Si la - transaction échoue, elle doit être conclue par un + Pour utiliser l'interface des grands objets (large object (lo) interface), + il est nécessaire de les placer dans un bloc de transaction. Un bloc + de transaction commence avec <command>begin</command> et si la transaction + se termine avec un <command>commit</command> et <command>end</command>. Si + la transaction échoue, elle doit être conclue par un <command>abort</command> et <command>rollback</command>. <example> <title>Utilisation des objets de grande taille (Large Objects)</title> <programlisting role="php"> <?php -$database = pg_connect("", "", "", "", "jacarta"); -pg_exec($database, "begin"); - $oid = pg_locreate($database); - echo "$oid\n"; - $handle = pg_loopen($database, $oid, "w"); - echo "$handle\n"; - pg_lowrite($handle, "gaga"); - pg_loclose($handle); - pg_exec($database, "commit") - pg_exec($database, "end") + $database = pg_connect("", "", "", "", "jacarta"); + pg_exec($database, "begin"); + $oid = pg_locreate($database); + echo "$oid\n"; + $handle = pg_loopen($database, $oid, "w"); + echo "$handle\n"; + pg_lowrite($handle, "gaga"); + pg_loclose($handle); + pg_exec($database, "commit") + pg_exec($database, "end") ?> </programlisting> </example> @@ -109,7 +113,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_close</function></funcdef> + <funcdef>boolean <function>pg_close</function></funcdef> <paramdef>resource <parameter>connection</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -121,9 +125,9 @@ </para> <note> <para> - Il n'est généralement pas nécessaire de fermer une connexion - non persistante, car elles sont automatiquement fermées à la fin - d'un script. + Il n'est généralement pas nécessaire de fermer une + connexion non persistante, car elles sont automatiquement fermées + à la fin d'un script. </para> </note> <para> @@ -160,11 +164,16 @@ </programlisting> </example> </para> + <para> + Voir aussi + <function>pg_numfields</function> et + <function>pg_numrows</function>. + </para> </refsect1> </refentry> <refentry id="function.pg-connect"> <refnamediv> - <refname>pg_Connect</refname> + <refname>pg_connect</refname> <refpurpose>Ouvre une connexion.</refpurpose> </refnamediv> <refsect1> @@ -172,6 +181,27 @@ <funcsynopsis> <funcprototype> <funcdef>resource <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + <funcprototype> + <funcdef>resource <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>options</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + <funcprototype> + <funcdef>resource <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>options</parameter></paramdef> + <paramdef>string <parameter>tty</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + <funcprototype> + <funcdef>resource <function>pg_connect</function></funcdef> <paramdef>string <parameter>conn_string</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -181,20 +211,20 @@ à un serveur PostgreSQL. Les arguments doivent être placé entre guillemets. <example> - <title>Using pg_connect arguments</title> - <programlisting role="php"> + <title>Exemples avec <function>pg_connect</function></title> + <programlisting role="php"> <?php -$dbconn = pg_connect("dbname=marie"); -//connexion à une base de données nommée "marie" -$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); -//connexion à une base de données nommée "marie" sur l'hôte "localhost" sur le port "5432" -$dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton password=baaaa"); -//connection à une base de données nommée "marie" sur le serveur "mouton" avec -// un nom d'utilisateur et le mot de passe associé + $dbconn = pg_connect("dbname=marie"); + //connexion à une base de données nommée "marie" + $dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); + //connexion à une base de données nommée "marie" sur l'hôte "localhost" sur le port "5432" + $dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton password=baaaa"); + //connexion à une base de données nommée "marie" sur le serveur "mouton" avec + // un nom d'utilisateur et le mot de passe associé ?> - </programlisting> + </programlisting> </example> - Les arguments disponbiles comptent notamment <parameter>dbname</parameter> + Les arguments disponibles comptent notamment <parameter>dbname</parameter> <parameter>port</parameter>, <parameter>host</parameter>, <parameter>tty</parameter>, <parameter>options</parameter>, <parameter>user</parameter>, et <parameter>password</parameter> @@ -204,13 +234,20 @@ nécessaire aux autres fonctions PostgreSQL. Vous pouvez ouvrir plusieurs connexions simultanées. </para> + <para> + Si un deuxième appel à <function>pg_connect</function> est + fait avec les mêmes arguments, aucune nouvelle connexion ne sera + établie, mais la connexion précédente sera + retournée. + </para> <para> - L'ancienne syntaxe - <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> - est obsolète. + L'ancienne syntaxe <command> + $conn = pg_connect("host", "port", "options", "tty", "dbname") + </command> est obsolète. </para> <para> - Voir aussi <function>pg_pconnect</function>. + Voir aussi + <function>pg_pconnect</function>. </para> </refsect1> </refentry> @@ -243,7 +280,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_end_copy</function></funcdef> + <funcdef>boolean <function>pg_end_copy</function></funcdef> <paramdef>resource <parameter><optional>connection</optional></parameter> </paramdef> @@ -251,10 +288,10 @@ </funcsynopsis> <para> <function>pg_end_copy</function> synchronise le client PostgreSQL (ici PHP) - avec le serveur, après une opération de copie. Il faut utiliser - cette fonction, sous peine de recevoir une erreur "out of sync" - (désynchronisé). Retourne &true; - en cas de succès, et &false; sinon. + avec le serveur, après une opération de copie. Il faut + utiliser cette fonction, sous peine de recevoir une erreur "out of sync" + (désynchronisé). <function>pg_end_copy</function> retourne + &true; en cas de succès, et &false; sinon. </para> <para> Pour plus de détails et un exemple voyez : @@ -303,8 +340,8 @@ </funcsynopsis> <para> <function>pg_exec</function> retourne un index de résultat, - si la requête a été correctement exécutée, - et &false; en cas d'échec, ou si + si la requête a été correctement + exécutée, et &false; en cas d'échec, ou si la connexion connection n'était pas un index de connexion valide. En cas d'erreur, le message d'erreur peut être obtenu grâce à la fonction <function>pg_errormessage</function>, si l'index de connexion @@ -372,7 +409,7 @@ qu'elle fournit un confort d'utilisation notable. </para> <para> - Pour plus de détails, reportez vous à + Pour plus de détails, reportez-vous à <function>pg_fetch_row</function>. </para> <example> @@ -429,7 +466,7 @@ (les nombres ne sont pas autorisés comme nom de membre). </para> <para> - L'argument optionnel <parameter><optional>result_type</optional></parameter> de + L'argument optionnel <parameter>result_type</parameter> de <parameter>result_type</parameter> est une constante qui peut prendre les valeurs suivantes : PGSQL_ASSOC, PGSQL_NUM, et PGSQL_BOTH. <note> @@ -445,10 +482,11 @@ <function>pg_fetch_row</function> (la différence est non significative). </para> <para> - Voir aussi: <function>pg_fetch_array</function> et + Voir aussi + <function>pg_fetch_array</function> et <function>pg_fetch_row</function>. <example> - <title>Postgres fetch object</title> + <title>Lecture d'un objet Postgres</title> <programlisting role="php"> <?php $database = "verlag"; @@ -523,8 +561,10 @@ lorsqu'il n'y aura plus de lignes. </para> <para> - Voir aussi: <function>pg_fetch_array</function>, - <function>pg_fetch_object</function> et <function>pg_result</function>. + Voir aussi + <function>pg_fetch_array</function>, + <function>pg_fetch_object</function> et + <function>pg_result</function>. <example> <title>Postgres retourne une ligne</title> <programlisting role="php"> @@ -545,7 +585,7 @@ for ($j=0; $j<count($r); $j++) { echo "$r[$j]&nbsp;"; } - echo "<BR>"; + echo "<br>"; } ?> </programlisting> @@ -662,9 +702,10 @@ </funcsynopsis> <para> <function>pg_fieldsize</function> retourne la taille interne de stockage - d'un champs donné, en octets. Retourne -1 si la taille est variable. - RetourneFALSEen cas d'erreur. La numérotation des colonnes - commence à 0. + d'un champs donné, en octets. <function>pg_fieldsize</function> + retourne -1 si la taille est variable. <function>pg_fieldsize</function> + retourne <literal>FALSE</literal> en cas d'erreur. La numérotation + des colonnes commence à 0. </para> </refsect1> </refentry> @@ -729,7 +770,7 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_getlastoid</function> sert à lire l' Oid assigné + <function>pg_getlastoid</function> sert à lire l'Oid assigné à un tuple inséré, si l'index de résultat a été obtenu avec la fonction <function>pg_exec</function>, dont la requête était exclusivement SQL INSERT. Cette fonction @@ -812,7 +853,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_loexport</function></funcdef> + <funcdef>boolean <function>pg_loexport</function></funcdef> <paramdef>resource <parameter>oid</parameter> </paramdef> @@ -825,9 +866,11 @@ </funcprototype> </funcsynopsis> <para> - <parameter>oid</parameter> est un identifiant d'objet de grande taille - qui sera exporté dans le fichier <parameter>filename</parameter>, qui - spécifie son chemin. RetourneFALSEsi une erreur survient, + <function>pg_loexport</function> exporte un objet de grande taille + dans un fichier. <parameter>oid</parameter> est un identifiant d'objet de + grande taille qui sera exporté dans le fichier + <parameter>filename</parameter>, + qui spécifie son chemin. RetourneFALSEsi une erreur survient, et &true; en cas de succès. N'oubliez pas que la manipulation d'un objet de grande taille dans PostgreSQL doit intervenir dans une transaction. @@ -855,7 +898,7 @@ <para> <parameter>filename</parameter> est le chemin jusqu'à un fichier qui servira de source pour créer un objet de grande taille. - La fonction retourneFALSEen cas d'erreur, et sinon + La fonction retourne <literal>FALSE</literal> en cas d'erreur, et sinon un identifiant d'objet, créé directement à la bonne taille. N'oubliez pas que la manipulation d'un objet de grande taille dans PostgreSQL doit intervenir dans une transaction. @@ -926,7 +969,7 @@ <para> <function>pg_loreadall</function> lit un objet de grande taille en totalité et le passe directement au client, après les - entêtes adéquats. Cette fonction est prévue + en-têtes adéquates. Cette fonction est prévue pour transmettre des sons ou des images. </para> </refsect1> @@ -946,7 +989,7 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_lounlink</function> efface l' objet de grande taille dont + <function>pg_lounlink</function> efface l'objet de grande taille dont l'identifiant est <parameter>lobjid</parameter>. </para> </refsect1> @@ -969,7 +1012,7 @@ <function>pg_lowrite</function> écrit dans l'objet de grande taille autant de données possible, issues de la variable <parameter>buf</parameter> et retourne le nombre d'octets - réellement écrits, ouFALSEen cas d'erreur. + réellement écrits, ou <literal>FALSE</literal> en cas d'erreur. <parameter>fd</parameter> est un descripteut d'objet de grande taille, obtenu avec <function>pg_loopen</function>. </para> @@ -994,6 +1037,11 @@ un identifiant de résultat valide retourné par <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur. </para> + <para> + Voir aussi + <function>pg_numrows</function> et + <function>pg_cmdtuples</function>. + </para> </refsect1> </refentry> <refentry id="function.pg-numrows"> @@ -1015,6 +1063,11 @@ identifiant de résultat valide retourné par <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur. </para> + <para> + Voir aussi + <function>pg_numfields</function> et + <function>pg_cmdtuples</function>. + </para> </refsect1> </refentry> <refentry id="function.pg-options"> @@ -1102,7 +1155,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_put_line</function></funcdef> + <funcdef>boolean <function>pg_put_line</function></funcdef> <paramdef>resource <parameter><optional>connection_id</optional></parameter> </paramdef> @@ -1113,9 +1166,10 @@ <function>pg_put_line</function> envoie une chaîne (terminée par &null;) au serveur PostgreSQL. Ceci est pratique pour effectuer des insertions très rapides dans une table, initiée par une - opération de copie PostgreSQL copy-operation. Le caractère final - &null; est automatiquement ajouté. Retourne &true; - en cas de succès, et &false;. + opération de copie PostgreSQL copy-operation. Le caractère + final &null; est automatiquement ajouté. + <function>pg_put_line</function> retourne &true; en cas de succès, + et &false;. </para> <note> <para> @@ -1125,7 +1179,8 @@ </para> </note> <para> - Voir aussi <function>pg_end_copy</function>. + Voir aussi + <function>pg_end_copy</function>. <example> <title>Insertion à grande vitesse dans une table</title> <programlisting role="php"> @@ -1182,7 +1237,7 @@ <refnamediv> <refname>pg_set_client_encoding</refname> <refpurpose> - Choisi l'encodage du client + Choisit l'encodage du client </refpurpose> </refnamediv> <refsect1> @@ -1217,7 +1272,8 @@ </para> </note> <para> - Voir aussi <function>pg_client_encoding</function>. + Voir aussi + <function>pg_client_encoding</function>. </para> </refsect1> </refentry> @@ -1256,7 +1312,8 @@ </para> </note> <para> - Voir aussi<function>pg_set_client_encoding</function>. + Voir aussi + <function>pg_set_client_encoding</function>. </para> </refsect1> </refentry> @@ -1269,7 +1326,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_trace</function></funcdef> + <funcdef>boolean <function>pg_trace</function></funcdef> <paramdef>string <parameter>filename</parameter> </paramdef> @@ -1298,11 +1355,14 @@ Par défaut, c'est la dernière ouverte. </para> <para> - Retourne &true; si <parameter>filename</parameter> a pu être ouvert en + <function>pg_trace</function> retourne &true; si + <parameter>filename</parameter> a pu être ouvert en écriture, etFALSEsinon. </para> <para> - Voir aussi <function>fopen</function> et <function>pg_untrace</function>. + Voir aussi + <function>fopen</function> et + <function>pg_untrace</function>. </para> </refsect1> </refentry> @@ -1314,8 +1374,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>pg_tty</function></funcdef> <paramdef>resource <parameter>connection_id</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>pg_tty</function> retourne le nom de tty de la connexion @@ -1332,7 +1394,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_untrace</function></funcdef> + <funcdef>boolean <function>pg_untrace</function></funcdef> <paramdef>resource <parameter><optional>connection</optional></parameter> </paramdef> @@ -1348,7 +1410,8 @@ <function>pg_untrace</function> retourne toujours &true;. </para> <para> - Voir aussi <function>pg_trace</function>. + Voir aussi + <function>pg_trace</function>. </para> </refsect1> </refentry>
Index: phpdoc/fr/functions/pgsql.xml diff -u phpdoc/fr/functions/pgsql.xml:1.12 phpdoc/fr/functions/pgsql.xml:1.13 --- phpdoc/fr/functions/pgsql.xml:1.12 Sat Jul 7 18:22:20 2001 +++ phpdoc/fr/functions/pgsql.xml Thu Nov 1 11:31:16 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.13 $ --> <reference id="ref.pgsql"> <title>PostgreSQL</title> <titleabbrev>PostgreSQL</titleabbrev> @@ -12,8 +14,8 @@ il est Open Source et dans le domaine public. </para> <para> - PostgreSQL est disponible sans frais. La version actuelle est disponible à - (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>. + PostgreSQL est disponible sans frais. La version actuelle est disponible + à (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>. </para> <para> Depuis la version 6.3 (03/02/1998) PostgreSQL utilise les sockets UNIX, et @@ -71,30 +73,32 @@ </para> <para> L'ancienne syntaxe : - <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> + <command> + $conn = pg_connect("host", "port", "options", "tty", "dbname") + </command> est obsolète. </para> <para> - Pour utiliser l'interface des grands objets (large object (lo) interface), il - est nécessaire de les placer dans un bloc de transaction. Un bloc de - transaction commence avec <command>begin</command> et si la transaction se - termine avec un <command>commit</command> et <command>end</command>. Si la - transaction échoue, elle doit être conclue par un + Pour utiliser l'interface des grands objets (large object (lo) interface), + il est nécessaire de les placer dans un bloc de transaction. Un bloc + de transaction commence avec <command>begin</command> et si la transaction + se termine avec un <command>commit</command> et <command>end</command>. Si + la transaction échoue, elle doit être conclue par un <command>abort</command> et <command>rollback</command>. <example> <title>Utilisation des objets de grande taille (Large Objects)</title> <programlisting role="php"> <?php -$database = pg_connect("", "", "", "", "jacarta"); -pg_exec($database, "begin"); - $oid = pg_locreate($database); - echo "$oid\n"; - $handle = pg_loopen($database, $oid, "w"); - echo "$handle\n"; - pg_lowrite($handle, "gaga"); - pg_loclose($handle); - pg_exec($database, "commit") - pg_exec($database, "end") + $database = pg_connect("", "", "", "", "jacarta"); + pg_exec($database, "begin"); + $oid = pg_locreate($database); + echo "$oid\n"; + $handle = pg_loopen($database, $oid, "w"); + echo "$handle\n"; + pg_lowrite($handle, "gaga"); + pg_loclose($handle); + pg_exec($database, "commit") + pg_exec($database, "end") ?> </programlisting> </example> @@ -109,7 +113,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_close</function></funcdef> + <funcdef>boolean <function>pg_close</function></funcdef> <paramdef>resource <parameter>connection</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -121,9 +125,9 @@ </para> <note> <para> - Il n'est généralement pas nécessaire de fermer une connexion - non persistante, car elles sont automatiquement fermées à la fin - d'un script. + Il n'est généralement pas nécessaire de fermer une + connexion non persistante, car elles sont automatiquement fermées + à la fin d'un script. </para> </note> <para> @@ -160,11 +164,16 @@ </programlisting> </example> </para> + <para> + Voir aussi + <function>pg_numfields</function> et + <function>pg_numrows</function>. + </para> </refsect1> </refentry> <refentry id="function.pg-connect"> <refnamediv> - <refname>pg_Connect</refname> + <refname>pg_connect</refname> <refpurpose>Ouvre une connexion.</refpurpose> </refnamediv> <refsect1> @@ -172,6 +181,27 @@ <funcsynopsis> <funcprototype> <funcdef>resource <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + <funcprototype> + <funcdef>resource <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>options</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + <funcprototype> + <funcdef>resource <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>options</parameter></paramdef> + <paramdef>string <parameter>tty</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + <funcprototype> + <funcdef>resource <function>pg_connect</function></funcdef> <paramdef>string <parameter>conn_string</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -181,20 +211,20 @@ à un serveur PostgreSQL. Les arguments doivent être placé entre guillemets. <example> - <title>Using pg_connect arguments</title> - <programlisting role="php"> + <title>Exemples avec <function>pg_connect</function></title> + <programlisting role="php"> <?php -$dbconn = pg_connect("dbname=marie"); -//connexion à une base de données nommée "marie" -$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); -//connexion à une base de données nommée "marie" sur l'hôte "localhost" sur le port "5432" -$dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton password=baaaa"); -//connection à une base de données nommée "marie" sur le serveur "mouton" avec -// un nom d'utilisateur et le mot de passe associé + $dbconn = pg_connect("dbname=marie"); + //connexion à une base de données nommée "marie" + $dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); + //connexion à une base de données nommée "marie" sur l'hôte "localhost" sur le port "5432" + $dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton password=baaaa"); + //connexion à une base de données nommée "marie" sur le serveur "mouton" avec + // un nom d'utilisateur et le mot de passe associé ?> - </programlisting> + </programlisting> </example> - Les arguments disponbiles comptent notamment <parameter>dbname</parameter> + Les arguments disponibles comptent notamment <parameter>dbname</parameter> <parameter>port</parameter>, <parameter>host</parameter>, <parameter>tty</parameter>, <parameter>options</parameter>, <parameter>user</parameter>, et <parameter>password</parameter> @@ -204,13 +234,20 @@ nécessaire aux autres fonctions PostgreSQL. Vous pouvez ouvrir plusieurs connexions simultanées. </para> + <para> + Si un deuxième appel à <function>pg_connect</function> est + fait avec les mêmes arguments, aucune nouvelle connexion ne sera + établie, mais la connexion précédente sera + retournée. + </para> <para> - L'ancienne syntaxe - <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> - est obsolète. + L'ancienne syntaxe <command> + $conn = pg_connect("host", "port", "options", "tty", "dbname") + </command> est obsolète. </para> <para> - Voir aussi <function>pg_pconnect</function>. + Voir aussi + <function>pg_pconnect</function>. </para> </refsect1> </refentry> @@ -243,7 +280,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_end_copy</function></funcdef> + <funcdef>boolean <function>pg_end_copy</function></funcdef> <paramdef>resource <parameter><optional>connection</optional></parameter> </paramdef> @@ -251,10 +288,10 @@ </funcsynopsis> <para> <function>pg_end_copy</function> synchronise le client PostgreSQL (ici PHP) - avec le serveur, après une opération de copie. Il faut utiliser - cette fonction, sous peine de recevoir une erreur "out of sync" - (désynchronisé). Retourne &true; - en cas de succès, et &false; sinon. + avec le serveur, après une opération de copie. Il faut + utiliser cette fonction, sous peine de recevoir une erreur "out of sync" + (désynchronisé). <function>pg_end_copy</function> retourne + &true; en cas de succès, et &false; sinon. </para> <para> Pour plus de détails et un exemple voyez : @@ -303,8 +340,8 @@ </funcsynopsis> <para> <function>pg_exec</function> retourne un index de résultat, - si la requête a été correctement exécutée, - et &false; en cas d'échec, ou si + si la requête a été correctement + exécutée, et &false; en cas d'échec, ou si la connexion connection n'était pas un index de connexion valide. En cas d'erreur, le message d'erreur peut être obtenu grâce à la fonction <function>pg_errormessage</function>, si l'index de connexion @@ -372,7 +409,7 @@ qu'elle fournit un confort d'utilisation notable. </para> <para> - Pour plus de détails, reportez vous à + Pour plus de détails, reportez-vous à <function>pg_fetch_row</function>. </para> <example> @@ -429,7 +466,7 @@ (les nombres ne sont pas autorisés comme nom de membre). </para> <para> - L'argument optionnel <parameter><optional>result_type</optional></parameter> de + L'argument optionnel <parameter>result_type</parameter> de <parameter>result_type</parameter> est une constante qui peut prendre les valeurs suivantes : PGSQL_ASSOC, PGSQL_NUM, et PGSQL_BOTH. <note> @@ -445,10 +482,11 @@ <function>pg_fetch_row</function> (la différence est non significative). </para> <para> - Voir aussi: <function>pg_fetch_array</function> et + Voir aussi + <function>pg_fetch_array</function> et <function>pg_fetch_row</function>. <example> - <title>Postgres fetch object</title> + <title>Lecture d'un objet Postgres</title> <programlisting role="php"> <?php $database = "verlag"; @@ -523,8 +561,10 @@ lorsqu'il n'y aura plus de lignes. </para> <para> - Voir aussi: <function>pg_fetch_array</function>, - <function>pg_fetch_object</function> et <function>pg_result</function>. + Voir aussi + <function>pg_fetch_array</function>, + <function>pg_fetch_object</function> et + <function>pg_result</function>. <example> <title>Postgres retourne une ligne</title> <programlisting role="php"> @@ -545,7 +585,7 @@ for ($j=0; $j<count($r); $j++) { echo "$r[$j]&nbsp;"; } - echo "<BR>"; + echo "<br>"; } ?> </programlisting> @@ -662,9 +702,10 @@ </funcsynopsis> <para> <function>pg_fieldsize</function> retourne la taille interne de stockage - d'un champs donné, en octets. Retourne -1 si la taille est variable. - RetourneFALSEen cas d'erreur. La numérotation des colonnes - commence à 0. + d'un champs donné, en octets. <function>pg_fieldsize</function> + retourne -1 si la taille est variable. <function>pg_fieldsize</function> + retourne <literal>FALSE</literal> en cas d'erreur. La numérotation + des colonnes commence à 0. </para> </refsect1> </refentry> @@ -729,7 +770,7 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_getlastoid</function> sert à lire l' Oid assigné + <function>pg_getlastoid</function> sert à lire l'Oid assigné à un tuple inséré, si l'index de résultat a été obtenu avec la fonction <function>pg_exec</function>, dont la requête était exclusivement SQL INSERT. Cette fonction @@ -812,7 +853,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_loexport</function></funcdef> + <funcdef>boolean <function>pg_loexport</function></funcdef> <paramdef>resource <parameter>oid</parameter> </paramdef> @@ -825,9 +866,11 @@ </funcprototype> </funcsynopsis> <para> - <parameter>oid</parameter> est un identifiant d'objet de grande taille - qui sera exporté dans le fichier <parameter>filename</parameter>, qui - spécifie son chemin. RetourneFALSEsi une erreur survient, + <function>pg_loexport</function> exporte un objet de grande taille + dans un fichier. <parameter>oid</parameter> est un identifiant d'objet de + grande taille qui sera exporté dans le fichier + <parameter>filename</parameter>, + qui spécifie son chemin. RetourneFALSEsi une erreur survient, et &true; en cas de succès. N'oubliez pas que la manipulation d'un objet de grande taille dans PostgreSQL doit intervenir dans une transaction. @@ -855,7 +898,7 @@ <para> <parameter>filename</parameter> est le chemin jusqu'à un fichier qui servira de source pour créer un objet de grande taille. - La fonction retourneFALSEen cas d'erreur, et sinon + La fonction retourne <literal>FALSE</literal> en cas d'erreur, et sinon un identifiant d'objet, créé directement à la bonne taille. N'oubliez pas que la manipulation d'un objet de grande taille dans PostgreSQL doit intervenir dans une transaction. @@ -926,7 +969,7 @@ <para> <function>pg_loreadall</function> lit un objet de grande taille en totalité et le passe directement au client, après les - entêtes adéquats. Cette fonction est prévue + en-têtes adéquates. Cette fonction est prévue pour transmettre des sons ou des images. </para> </refsect1> @@ -946,7 +989,7 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_lounlink</function> efface l' objet de grande taille dont + <function>pg_lounlink</function> efface l'objet de grande taille dont l'identifiant est <parameter>lobjid</parameter>. </para> </refsect1> @@ -969,7 +1012,7 @@ <function>pg_lowrite</function> écrit dans l'objet de grande taille autant de données possible, issues de la variable <parameter>buf</parameter> et retourne le nombre d'octets - réellement écrits, ouFALSEen cas d'erreur. + réellement écrits, ou <literal>FALSE</literal> en cas d'erreur. <parameter>fd</parameter> est un descripteut d'objet de grande taille, obtenu avec <function>pg_loopen</function>. </para> @@ -994,6 +1037,11 @@ un identifiant de résultat valide retourné par <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur. </para> + <para> + Voir aussi + <function>pg_numrows</function> et + <function>pg_cmdtuples</function>. + </para> </refsect1> </refentry> <refentry id="function.pg-numrows"> @@ -1015,6 +1063,11 @@ identifiant de résultat valide retourné par <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur. </para> + <para> + Voir aussi + <function>pg_numfields</function> et + <function>pg_cmdtuples</function>. + </para> </refsect1> </refentry> <refentry id="function.pg-options"> @@ -1102,7 +1155,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_put_line</function></funcdef> + <funcdef>boolean <function>pg_put_line</function></funcdef> <paramdef>resource <parameter><optional>connection_id</optional></parameter> </paramdef> @@ -1113,9 +1166,10 @@ <function>pg_put_line</function> envoie une chaîne (terminée par &null;) au serveur PostgreSQL. Ceci est pratique pour effectuer des insertions très rapides dans une table, initiée par une - opération de copie PostgreSQL copy-operation. Le caractère final - &null; est automatiquement ajouté. Retourne &true; - en cas de succès, et &false;. + opération de copie PostgreSQL copy-operation. Le caractère + final &null; est automatiquement ajouté. + <function>pg_put_line</function> retourne &true; en cas de succès, + et &false;. </para> <note> <para> @@ -1125,7 +1179,8 @@ </para> </note> <para> - Voir aussi <function>pg_end_copy</function>. + Voir aussi + <function>pg_end_copy</function>. <example> <title>Insertion à grande vitesse dans une table</title> <programlisting role="php"> @@ -1182,7 +1237,7 @@ <refnamediv> <refname>pg_set_client_encoding</refname> <refpurpose> - Choisi l'encodage du client + Choisit l'encodage du client </refpurpose> </refnamediv> <refsect1> @@ -1217,7 +1272,8 @@ </para> </note> <para> - Voir aussi <function>pg_client_encoding</function>. + Voir aussi + <function>pg_client_encoding</function>. </para> </refsect1> </refentry> @@ -1256,7 +1312,8 @@ </para> </note> <para> - Voir aussi<function>pg_set_client_encoding</function>. + Voir aussi + <function>pg_set_client_encoding</function>. </para> </refsect1> </refentry> @@ -1269,7 +1326,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_trace</function></funcdef> + <funcdef>boolean <function>pg_trace</function></funcdef> <paramdef>string <parameter>filename</parameter> </paramdef> @@ -1298,11 +1355,14 @@ Par défaut, c'est la dernière ouverte. </para> <para> - Retourne &true; si <parameter>filename</parameter> a pu être ouvert en + <function>pg_trace</function> retourne &true; si + <parameter>filename</parameter> a pu être ouvert en écriture, etFALSEsinon. </para> <para> - Voir aussi <function>fopen</function> et <function>pg_untrace</function>. + Voir aussi + <function>fopen</function> et + <function>pg_untrace</function>. </para> </refsect1> </refentry> @@ -1314,8 +1374,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>pg_tty</function></funcdef> <paramdef>resource <parameter>connection_id</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>pg_tty</function> retourne le nom de tty de la connexion @@ -1332,7 +1394,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>pg_untrace</function></funcdef> + <funcdef>boolean <function>pg_untrace</function></funcdef> <paramdef>resource <parameter><optional>connection</optional></parameter> </paramdef> @@ -1348,7 +1410,8 @@ <function>pg_untrace</function> retourne toujours &true;. </para> <para> - Voir aussi <function>pg_trace</function>. + Voir aussi + <function>pg_trace</function>. </para> </refsect1> </refentry>