cvs: phpdoc-fr /reference/pgsql/functions pg-affected-rows.xml pg-cancel-query.xml pg-connection-busy.xml pg-connection-reset.xml
pg-connection-status.xml pg-convert.xml pg-copy-from.xml pg-copy-to.xml pg-delete.xml pg-escape-bytea.xml pg-escape-string.xml pg-fetch-all.xml
pg-fetch-assoc.xml pg-fetch-result.xml pg-field-is-null.xml pg-get-notify.xml pg-get-pid.xml pg-get-result.xml pg-insert.xml pg-last-error.xml
pg-last-notice.xml pg-last-oid.xml pg-lo-seek.xml pg-lo-tell.xml pg-meta-data.xml pg-num-fields.xml pg-ping.xml pg-query.xml pg-result-error.xml
pg-result-seek.xml pg-result-status.xml pg-select.xml pg-send-query.xml pg-unescape-bytea.xml pg-update.xml
| From: | Damien Seguy | Date: | Fri, 22 Nov 2002 02:31:12 +0000 |
| Subject: | cvs: phpdoc-fr /reference/pgsql/functions pg-affected-rows.xml pg-cancel-query.xml pg-connection-busy.xml pg-connection-reset.xml pg-connection-status.xml pg-convert.xml pg-copy-from.xml pg-copy-to.xml pg-delete.xml pg-escape-bytea.xml pg-escape-string.xml pg-fetch-all.xml pg-fetch-assoc.xml pg-fetch-result.xml pg-field-is-null.xml pg-get-notify.xml pg-get-pid.xml pg-get-result.xml pg-insert.xml pg-last-error.xml pg-last-notice.xml pg-last-oid.xml pg-lo-seek.xml pg-lo-tell.xml pg-meta-data.xml pg-num-fields.xml pg-ping.xml pg-query.xml pg-result-error.xml pg-result-seek.xml pg-result-status.xml pg-select.xml pg-send-query.xml pg-unescape-bytea.xml pg-update.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-126@lists.php.net to get a copy of this message | ||
dams Thu Nov 21 21:31:12 2002 EDT
Added files:
/phpdoc-fr/reference/pgsql/functions pg-cancel-query.xml
pg-connection-busy.xml
pg-connection-reset.xml
pg-connection-status.xml
pg-convert.xml
pg-copy-from.xml
pg-copy-to.xml pg-delete.xml
pg-escape-bytea.xml
pg-escape-string.xml
pg-fetch-all.xml
pg-fetch-assoc.xml
pg-fetch-result.xml
pg-get-notify.xml
pg-get-pid.xml
pg-get-result.xml
pg-insert.xml
pg-last-error.xml
pg-last-notice.xml
pg-last-oid.xml pg-lo-seek.xml
pg-lo-tell.xml
pg-meta-data.xml pg-ping.xml
pg-query.xml
pg-result-error.xml
pg-result-seek.xml
pg-result-status.xml
pg-select.xml
pg-send-query.xml
pg-unescape-bytea.xml
pg-update.xml
Modified files:
/phpdoc-fr/reference/pgsql/functions pg-affected-rows.xml
pg-field-is-null.xml
pg-num-fields.xml
Log:
correction for build
Index: phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml diff -u phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml:1.1 phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml:1.2 --- phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml:1.1 Sat Oct 19 14:50:22 2002 +++ phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml Thu Nov 21 21:31:10 2002 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-affected-rows"> <refnamediv> <refname>pg_affected_rows</refname> - <refpurpose>Retourne le nombre de lignes affectes</refpurpose> + <refpurpose>Retourne le nombre de lignes affectées</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,9 +14,9 @@ </methodsynopsis> <para> <function>pg_affected_rows</function> retourne le nombre de lignes - affectes par les requtes de type INSERT, UPDATE, et DELETE, - excutes par la fonction <function>pg_query</function>. Si aucune - ligne n'a t affecte, <function>pg_affected_rows</function> retourne 0. + affectées par les requêtes de type INSERT, UPDATE, et DELETE, + exécutées par la fonction <function>pg_query</function>. Si aucune + ligne n'a été affectée, <function>pg_affected_rows</function> retourne 0. <example> <title>Exemple avec <function>pg_affected_rows</function></title> <programlisting role="php"> @@ -24,7 +24,7 @@ <?php $result = pg_query($conn, "INSERT INTO editeur VALUES ('Auteur')"); $cmdtuples = pg_affected_rows($result); - echo $cmdtuples . " lignes ont t affectes."; + echo $cmdtuples . " lignes ont été affectées."; ?> ]]> </programlisting> Index: phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml diff -u phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml:1.1 phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml:1.2 --- phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml:1.1 Sat Oct 19 14:50:22 2002 +++ phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml Thu Nov 21 21:31:11 2002 @@ -19,7 +19,7 @@ &null;. <function>pg_field_is_null</function> retourne 0 si le champs n'est pas &null;. <function>pg_field_is_null</function> retourne 1 si le champs est à &null;. Le champs peut être identifié avec son nom ou - son index numérique (commenant à 0). + son index numérique (commençant à 0). </para> <note> <para> Index: phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml diff -u phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml:1.1 phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml:1.2 --- phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml:1.1 Sat Oct 19 14:50:22 2002 +++ phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml Thu Nov 21 21:31:11 2002 @@ -13,7 +13,7 @@ <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - <function>pg_Num_Fields</function> retourne le nombre de champs + <function>pg_num_fields</function> retourne le nombre de champs (ou colonnes) d'un résultat PostgreSQL. L'argument doit être un identifiant de résultat valide retourné par <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur. Index: phpdoc-fr/reference/pgsql/functions/pg-cancel-query.xml +++ phpdoc-fr/reference/pgsql/functions/pg-cancel-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-cancel-query"> <refnamediv> <refname>pg_cancel_query</refname> <refpurpose>Annule une requête asynchrone</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_cancel_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_cancel_query</function> annule la requête asynchrone, démarrée avec <function>pg_send_query</function>, sur la connexion <parameter>connection</parameter>. Vous ne pouvez pas annuler une requête démarrée avec <function>pg_query</function>. </para> <para> Voir aussi <function>pg_send_query</function> et <function>pg_connection_busy</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-connection-busy.xml +++ phpdoc-fr/reference/pgsql/functions/pg-connection-busy.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-connection-busy"> <refnamediv> <refname>pg_connection_busy</refname> <refpurpose>Vérifie si la connexion est occupée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_connection_busy</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_connection_busy</function> retourne &true; si la connexion est occupe. Si elle est occupée, une requête a déjà été lancée, et est en cours. Si <function>pg_get_result</function> est appelé, elle sera alors bloquée. </para> <para> Voir aussi <function>pg_connection_status</function> et <function>pg_get_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-connection-reset.xml +++ phpdoc-fr/reference/pgsql/functions/pg-connection-reset.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-connection-reset"> <refnamediv> <refname>pg_connection_reset</refname> <refpurpose>Reconnecte au serveur PostGresSQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_connection_reset</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_connection_reset</function> effectue une reconnexion au serveur, avec les mêmes paramètres que lors de la connexion précédente avec <parameter>connection</parameter>. Cette fonction est pratique pour le traitement des erreurs. &return.success; </para> <para> Voir aussi <function>pg_connect</function>, <function>pg_pconnect</function> et <function>pg_connection_status</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-connection-status.xml +++ phpdoc-fr/reference/pgsql/functions/pg-connection-status.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-connection-status"> <refnamediv> <refname>pg_connection_status</refname> <refpurpose>Lit le statut de la connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_connection_status</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_connection_status</function> retourne le statut de la connexion <parameter>connection</parameter>. Les valeurs possibles sont <literal>PGSQL_CONNECTION_OK</literal> (connexion correcte) et <literal>PGSQL_CONNECTION_BAD</literal> (connexion abandonnée). </para> <para> Voir aussi <function>pg_connection_busy</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-convert.xml +++ phpdoc-fr/reference/pgsql/functions/pg-convert.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-convert"> <refnamediv> <refname>pg_convert</refname> <refpurpose>Convertit un tableau associatif en une commande SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_convert</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_convert</function> vérifie et convertit le tableau associatif <literal>assoc_array</literal> en une requête SQL valide. </para> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_metadata</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-copy-from.xml +++ phpdoc-fr/reference/pgsql/functions/pg-copy-from.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-copy-from"> <refnamediv> <refname>pg_copy_from</refname> <refpurpose> Insère des lignes dans une table à partir d'un tableau </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_copy_from</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>rows</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>null_as</parameter></methodparam> </methodsynopsis> <para> <function>pg_copy_from</function> insère les éléments du tableau <parameter>rows</parameter> dans la tableau <parameter>table_name</parameter>. Cette fonction utilise la commande SQL interne <literal>COPY FROM</literal>. &return.success; </para> <para> Voir aussi <function>pg_copy_to</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-copy-to.xml +++ phpdoc-fr/reference/pgsql/functions/pg-copy-to.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-copy-to"> <refnamediv> <refname>pg_copy_to</refname> <refpurpose>Copie une table dans un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_copy_to</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>null_as</parameter></methodparam> </methodsynopsis> <para> <function>pg_copy_to</function> copie la table <parameter>table_name</parameter> dans un tableau, et le retourne. Cette fonction utilise la commande interne SQL <literal>COPY TO</literal> pour insérer les tableaux. En cas d'erreur, la fonction retourne &false;. </para> <para> Voir aussi <function>pg_copy_from</function> </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-delete.xml +++ phpdoc-fr/reference/pgsql/functions/pg-delete.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-delete"> <refnamediv> <refname>pg_delete</refname> <refpurpose>Efface des lignes</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>long</type><methodname>pg_delete</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_delete</function> efface les lignes de la table <parameter>table_name</parameter>, spécfiées par le tableau associatif <literal>assoc_array</literal>, qui est bâti sous la forme <literal>champs=>valeur</literal>. Si <literal>option</literal> est spécifié, <function>pg_convert</function> est appliqué à <literal>assoc_array</literal> avec cette option. </para> <example> <title>Exemple avec <function>pg_delete</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); // C'est sans proble, car $_POST est convertit automatiquement $res = pg_delete($db, 'post_log', $_POST); if ($res) { echo "Les données POSTées ont été effacées : $res\n"; } else { echo "Les données d'entrées sont erronées.\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-escape-bytea.xml +++ phpdoc-fr/reference/pgsql/functions/pg-escape-bytea.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-escape-bytea"> <refnamediv> <refname>pg_escape_bytea</refname> <refpurpose>Protège le caractères d'une chaîne binaire en mode bytea</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_escape_bytea</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>pg_escape_bytea</function> protège les caractères de la chaîne <parameter>data</parameter> avec le mode bytea. La chaîne protégée est retournée. </para> <note> <para> Lorsque vous utilisez une commande SELECT avec des données de type bytea, PostgreSQL retourne des valeurs octales, préfixées avec des anti-slash \ (e.g. \032). Les utilisateurs doivent effectuer la conversion en format binaire eux-même. </para> <para> <function>pg_escape_bytea</function> requiert PostgreSQL 7.2 ou plus récent. Avec PostgreSQL 7.2.0 et 7.2.1, les données de type bytea doivent être transtypée lorsque vous activez le support des chaînes de caractères multi-octets. i.e. <literal>INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);</literal>. PostgreSQL 7.2.2 ou plus récent ne requiert pas cette manipulation. Toutes fois, si le client et le serveur n'utilisent pas le même jeux de caractères, il peut arriver des erreurs. Il faut alors forcer le transtypage manuellement. </para> <para> Les futures versions de PostgreSQL supporteront une fonction de suppression de la protection. L'API &php; évoluera alors. </para> </note> <para> Voir aussi <function>pg_escape_string</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-escape-string.xml +++ phpdoc-fr/reference/pgsql/functions/pg-escape-string.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-escape-string"> <refnamediv> <refname>pg_escape_string</refname> <refpurpose>Protège une chaîne de caractères</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_escape_string</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>pg_escape_string</function> protège la chaîne de caractères <parameter>data</parameter>. Elle retourne la chaîne ainsi protégée. L'utilisation de cette fonction est recommandée, à la place de <function>addslashes</function>. </para> <note> <para> Cette fonction requiert PostgreSQL 7.2 ou plus récent. </para> </note> <para> Voir aussi <function>pg_escape_bytea</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-fetch-all.xml +++ phpdoc-fr/reference/pgsql/functions/pg-fetch-all.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-fetch-all"> <refnamediv> <refname>pg_fetch_all</refname> <refpurpose>Lit toutes les lignes d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_fetch_all</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_all</function> retourne un tableau qui contient toutes les lignes du résultat <parameter>result</parameter>. Elle retourne &false; s'il n'y a plus de lignes disponibles. </para> <para> <example> <title>Exemple avec <function>pg_fetch_all</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } $result = pg_query ($conn, "SELECT * FROM authors"); if (!$result) { echo "Une erreur est survenue.\n"; exit; } $arr = pg_fetch_all ($result, 0, PGSQL_NUM); var_dump($arr); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_fetch_row</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function> et <function>pg_fetch_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-fetch-assoc.xml +++ phpdoc-fr/reference/pgsql/functions/pg-fetch-assoc.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-fetch-assoc"> <refnamediv> <refname>pg_fetch_assoc</refname> <refpurpose>Lit une ligne sous forme de tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_fetch_assoc</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_assoc</function> retourne un tableau associatif qui contient la ligne en cours dans le résultat <parameter>result</parameter>. <function>pg_fetch_assoc</function> retourne &false; si il n'y a plus de lignes. </para> <para> <function>pg_fetch_assoc</function> est une version améliorée de <function>pg_fetch_row</function>. En plus de stocker les valeurs dans un tableau a index numérique, elle stocke aussi les données dans un tableau associatif, en utilisant les noms de colonnes comme index. </para> <para> <parameter>row</parameter> est le numéro de ligne à lire. Par défaut, il vaut 0. </para> <para> <function>pg_fetch_assoc</function> n'est pas significativement plus lente que <function>pg_fetch_row</function>, et elle apporte un confort d'utilisation apréciable. </para> <para> <example> <title>Exemple avec <function>pg_fetch_assoc</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } $result = pg_query ($conn, "SELECT * FROM authors"); if (!$result) { echo "Une erreur est survenue.\n"; exit; } $arr = pg_fetch_assoc ($result, 1, PGSQL_ASSOC); echo $arr["author"] . " <- array\n"; ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_fetch_row</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function> et <function>pg_fetch_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-fetch-result.xml +++ phpdoc-fr/reference/pgsql/functions/pg-fetch-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-fetch-result"> <refnamediv> <refname>pg_fetch_result</refname> <refpurpose>Retourne les valeurs d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>pg_fetch_result</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>row</parameter></methodparam> <methodparam><type>mixed</type><parameter>field</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_result</function> retourne les valeurs stockées dans la ressource de résultat <parameter>result</parameter>, retournée par <function>pg_query</function>. <parameter>row</parameter> est un entier. <parameter>field</parameter> est le nom du champs (sous forme de chaîne) ou un index de colonne (sous forme d'entier). <parameter>row</parameter> et <parameter>field</parameter> spécifie quelles cellules de la table de résultat doivent être lu. Le lignes sont numérotées à partir de 0. Au lieu de nommer le champs, vous pouvez utiliser le numéro de colonne. L'indexation des colonnes commence à 0. </para> <para> PostgreSQL dispose de nombreux types, et seuls les types basiques sont supportés ici. Tous les types <type>integer</type> <!-- FIXME: is that still true? PHP supports boolean&null now... --> <!-- Yes, supporting boolean&null breaks scripts. pg_fetch_array() can be used instead. I might take of this issue with additional ini directive. yohgaki@php.net --> sont retournées sous forme de <type>integer</type>. Tous les types de float, et nombres réels sont retournées sous forme de <type>float</type>. Les booléens sont retournées comme des "t" ou "f". Tous les autres types, y compris les tableaux, sont retournées sous forme de chaînes formatées, de la même manière que PostgreSQL vous les afficherait dans le client <command>psql</command>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-get-notify.xml +++ phpdoc-fr/reference/pgsql/functions/pg-get-notify.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.pg-get-notify"> <refnamediv> <refname>pg_get_notify</refname> <refpurpose>Lit le message de NOTIFY</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_get_notify</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> </methodsynopsis> <para> <function>pg_get_notify</function> reçoit le message de NOTIFY envoyé par une commande SQL <literal>NOTIFY</literal>. Pour lire le message associé, utilisez la commande <literal>LISTEN</literal>. Si il y a un message de notification avec cette connexion, un tableau sera retourné avec le message et le PID du serveur. Si il n'y a pas de message, <function>pg_get_notify</function> retourne &false;. </para> <para> <example> <title>Exemple avec <function>pg_get_notify</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } // coute le message 'author_updated' des autres processus pq_query($conn, 'LISTEN author_updated;'); $notify = pg_get_notify($conn); if (!$notify) print("Aucun message\n"); else print_r($notify); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_get_pid</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-get-pid.xml +++ phpdoc-fr/reference/pgsql/functions/pg-get-pid.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.pg-get-pid"> <refnamediv> <refname>pg_get_pid</refname> <refpurpose>Lit l'identifiant de processus du serveur</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_get_pid</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_get_pid</function> lit l'identifiant de processus du serveur PostGreSQL. Le PID est pratique pour vérifier si un message de <literal>NOTIFY</literal> a été envoyé par un autre processus ou pas. </para> <para> <example> <title>Exemple avec <function>pg_get_pid</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } // PID du serveur. Utilisez alors le PID avec pg_get_notify() $pid = pg_get_pid($conn); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_get_notify</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-get-result.xml +++ phpdoc-fr/reference/pgsql/functions/pg-get-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 --> <refentry id="function.pg-get-result"> <refnamediv> <refname>pg_get_result</refname> <refpurpose>Lit un résultat asynchrone</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>pg_get_result</methodname> <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_get_result</function> lit le résultat asynchrone d'une requête exécutée par <function>pg_send_query</function>. <function>pg_send_query</function> peut envoyer plusieurs requêtes à PostgreSQLet <function>pg_get_result</function> sert à lire les résultats un par un. <function>pg_get_result</function> retourne une ressource de résultat. Si il n'y a pas de résultat, <function>pg_get_result</function> retourne &false;. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-insert.xml +++ phpdoc-fr/reference/pgsql/functions/pg-insert.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-insert"> <refnamediv> <refname>pg_insert</refname> <refpurpose>Insère un tableau dans une table</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_insert</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_insert</function> insère le tableau <literal>assoc_array</literal> (bâtit sur le modèle <literal>champs=>valeur</literal> dans la table <literal>table_name</literal>. Si <literal>options</literal> est spécifié, <function>pg_convert</function> est appliqué à <literal>assoc_array</literal> avec cette option. </para> <example> <title>Exemple avec <function>pg_insert</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); // C'est correct, car $_POST est convertit automatiquement $res = pg_insert($db, 'post_log', $_POST); if ($res) { echo "Les données POSTées ont pu être enregistrée avec succès.\n"; } else { echo "Il y a un problème avec les données.\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-last-error.xml +++ phpdoc-fr/reference/pgsql/functions/pg-last-error.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-last-error"> <refnamediv> <refname>pg_last_error</refname> <refpurpose>Lit le dernier message d'erreur sur la connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_last_error</methodname> <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_error</function> retourne le dernier message d'erreur qui a été enregistré sur la connexion <parameter>connection</parameter>. </para> <para> Les messages d'erreur peuvent être écrasé par des appels internes à l'extension PostgreSQL(libpq) : il se peut que le message retourné ne soit pas approprié, notamment si plusieurs erreurs ont eu lieu dans le module. </para> <para> Utilisez <function>pg_result_error</function>, <function>pg_result_status</function> et <function>pg_connection_status</function> pour améliorer la gestion des erreurs. </para> <note> <para> <function>pg_last_error</function> s'appelait <literal>pg_errormessage()</literal>. </para> </note> <para> Voir aussi <function>pg_result_error</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-last-notice.xml +++ phpdoc-fr/reference/pgsql/functions/pg-last-notice.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-last-notice"> <refnamediv> <refname>pg_last_notice</refname> <refpurpose> Retourne la dernière note du serveur PostgreSQL. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_last_notice</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_notice</function> retourne la dernière note du serveur PostgreSQL, spécifiée par <parameter>connection</parameter>. Le serveur PostgreSQL envoie de snotes dans plusieurs cas, comme par exemple si la transaction ne peut être continuée. Avec <function>pg_last_notice</function>, vous pouvez éviter des requêtes inutiles en vérifiant si des notes liées à votre transaction ont été émises. </para> <warning> <para> Cette fonction est EXPERIMENTAL et elle n'est pas complètement implémentée. <function>pg_last_notice</function> a été ajoutée en PHP 4.0.6. Cependant, PHP 4.0.6 avait un problème avec la gestion des notes. L'utilisation du module PostgreSQL avec PHP 4.0.6 n'est pas recommandé, même si vous n'utilisez pas <function>pg_last_notice</function>. </para> <para> Cette fonction est totaltement implémentée en PHP 4.3.0. Les versions plus ancienne de PHP ignore les données de connexion au serveur. </para> </warning> <para> Le suivi des notes peut être rendu optionnel en mettant à 1 la directive de configuration <literal>pgsql.ignore_notice</literal>, à partir de PHP 4.3.0. </para> <para> L'enregistrement des notes peut être rendu optionnel en mettant la directive de configuration <literal>pgsql.log_notice</literal> à 0, à partir de PHP 4.3.0. A moins que <literal>pgsql.ignore_notice</literal> ne soit à 0, les notes ne seront pas enregistrées. </para> <para> Voir aussi <function>pg_query</function> et <function>pg_last_error</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-last-oid.xml +++ phpdoc-fr/reference/pgsql/functions/pg-last-oid.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-last-oid"> <refnamediv> <refname>pg_last_oid</refname> <refpurpose>Retourne l'identifiant du dernier objet</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_last_oid</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_oid</function> sert à lire le dernier <varname>oid</varname> assigné à un ligne, qui est stocké dans la ressource <parameter>result</parameter>, obtenu lors de la dernière commande <function>pg_query</function>. Il faut que cette commande ait été un INSERT. <function>pg_last_oid</function> retourne un entier positif si il y a eu un <varname>oid</varname> valide. <function>pg_last_oid</function> retourne &false; si une erreur est survenue,, ou si la commande utilisée avec <function>pg_query</function> n'était pas un INSERT, ou que cette commande a échoué. </para> <para> Le champs OID est devenu optionnel depuis PostgreSQL 7.2. Lorsque le champs OID n'est pas défini dans la table, le programmeur doit utiliser <function>pg_result_status</function> pour vérifier si la ligne a été correctement insérée. </para> <note> <para> <function>pg_last_oid</function> s'appelait<literal>pg_getlastoid()</literal>. </para> </note> <para> Voir aussi <function>pg_query</function> et <function>pg_result_status</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-lo-seek.xml +++ phpdoc-fr/reference/pgsql/functions/pg-lo-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-lo-seek"> <refnamediv> <refname>pg_lo_seek</refname> <refpurpose> Modifie la position dans un objet de grande taille </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_lo_seek</methodname> <methodparam><type>resource</type><parameter>large_object</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> </methodsynopsis> <para> <function>pg_lo_seek</function> modifie la position du pointeur dans l'objet de grande taille <parameter>large_object</parameter>. Le paramètre <parameter>whence</parameter> peut prendre les valeurs de <constant>PGSQL_SEEK_SET</constant>, <constant>PGSQL_SEEK_CUR</constant> ou <constant>PGSQL_SEEK_END</constant>. </para> <para> Voir aussi <function>pg_lo_tell</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-lo-tell.xml +++ phpdoc-fr/reference/pgsql/functions/pg-lo-tell.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.74 --> <refentry id="function.pg-lo-tell"> <refnamediv> <refname>pg_lo_tell</refname> <refpurpose>Retourne la position courante dans un objet de grande taille</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_lo_tell</methodname> <methodparam><type>resource</type><parameter>large_object</parameter></methodparam> </methodsynopsis> <para> <function>pg_lo_tell</function> retourne la position courante du pointeur de lecture sur l'objet de grande taille <parameter>large_object</parameter>. C'est le nombre d'octets depuis le dédut du fichier. </para> <para> Voir aussi <function>pg_lo_seek</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-meta-data.xml +++ phpdoc-fr/reference/pgsql/functions/pg-meta-data.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-meta-data"> <refnamediv> <refname>pg_meta_data</refname> <refpurpose>Lit les données méta de la table</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_meta_data</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> </methodsynopsis> <para> <function>pg_meta_data</function> retourne la définition de la table <literal>table_name</literal> sous forme de tableau. Si une erreur survient, <function>pg_meta_data</function> retourne &false;. </para> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-ping.xml +++ phpdoc-fr/reference/pgsql/functions/pg-ping.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-ping"> <refnamediv> <refname>pg_ping</refname> <refpurpose>Pingue la connexion à la base</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_ping</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_ping</function> pingue la connexion à la base de données, et essaie de se reconnecter si la connexion est perdue. <function>pg_ping</function> retourne &true; si la connexion est active, et &false; sinon. </para> <para> <example> <title>Exemple avec <function>pg_ping</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } if (!pg_ping($conn)) die("La connexion est morte\n"); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_connection_status</function> et <function>pg_connection_reset</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-query.xml +++ phpdoc-fr/reference/pgsql/functions/pg-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-query"> <refnamediv> <refname>pg_query</refname> <refpurpose>Exécute une requête</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>pg_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> <function>pg_query</function> retourne une ressource de résultat si la requête a pu être exécutée. Elle retourne &false; en cas d'échec, ou si la connexion n'est pas valide. Le détails sur les erreurs rencontrées est accessible via la fonction <function>pg_last_error</function>, si la connexion est valide. <function>pg_last_error</function> émet une requête SQL au serveur PostgreSQL, spécifé avec le paramètre <parameter>connection</parameter>. <parameter>connection</parameter> doit être une connexion valide, retournée par la fonction <function>pg_connect</function> ou <function>pg_pconnect</function>. La valeur retournée par cette fonction est une ressource de résultat. Pour accéder aux lignes lues, il faudra utiliser les autres fonctions PostgreSQL, telles que <function>pg_fetch_array</function>. <note> <simpara> <parameter>connection</parameter> est un paramètre optionnel de <function>pg_query</function>. Si <parameter>connection</parameter> est omis, la connexion par défaut sera utilisée. La connexion par défaut est la dernière connexion ouverte avec <function>pg_connect</function> ou <function>pg_pconnect</function>. </simpara> <simpara> Bien que <parameter>connection</parameter> puisse être omis, il n'est pas recommandé de le faire, car il peut se révéler difficile de retrouver la connexion dans un script. </simpara> </note> </para> <note> <para> Cette fonction s'appelait <literal>pg_exec()</literal>. <literal>pg_exec()</literal> est toujours disponible pour des raisons de compatibilité, mais les utilisateurs sont encouragés à utiliser le nouveau nom. </para> </note> <para> Voir aussi <function>pg_connect</function>, <function>pg_pconnect</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function>, <function>pg_num_rows</function> et <function>pg_affected_rows</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-result-error.xml +++ phpdoc-fr/reference/pgsql/functions/pg-result-error.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-result-error"> <refnamediv> <refname>pg_result_error</refname> <refpurpose>Lit le message d'erreur associé à un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_result_error</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_error</function> retourne le message d'erreur associé au résultat <parameter>result</parameter>. Par conséquent, l'utilisateur a des chances d'obtenir un message d'erreur plus approprié que via <function>pg_last_error</function>. </para> <para> Voir aussi <function>pg_query</function>, <function>pg_send_query</function>, <function>pg_get_result</function>, <function>pg_last_error</function> et <function>pg_last_notice</function> </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-result-seek.xml +++ phpdoc-fr/reference/pgsql/functions/pg-result-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-result-seek"> <refnamediv> <refname>pg_result_seek</refname> <refpurpose>Modifie la ligne courant dans un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_result_seek</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_seek</function> choisit la ligne <parameter>offset</parameter> comme ligne courante dans le résultat <parameter>result</parameter>. <function>pg_result_seek</function> retourne &false;, en cas d'erreur. </para> <para> Voir aussi <function>pg_fetch_row</function>, <function>pg_fetch_assoc</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function> et <function>pg_fetch_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-result-status.xml +++ phpdoc-fr/reference/pgsql/functions/pg-result-status.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 --> <refentry id="function.pg-result-status"> <refnamediv> <refname>pg_result_status</refname> <refpurpose>Lit le statut du résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_result_status</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_status</function> lit le statut du résultat <parameter>result</parameter>. Les valeurs retournée possibles sont <constant>PGSQL_EMPTY_QUERY</constant>, <constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>, <constant>PGSQL_COPY_TO</constant>, <constant>PGSQL_COPY_FROM</constant>, <constant>PGSQL_BAD_RESPONSE</constant>, <constant>PGSQL_NONFATAL_ERROR</constant> et <constant>PGSQL_FATAL_ERROR</constant>. </para> <para> Voir aussi <function>pg_connection_status</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-select.xml +++ phpdoc-fr/reference/pgsql/functions/pg-select.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-select"> <refnamediv> <refname>pg_select</refname> <refpurpose>Effectue une selection</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_select</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_select</function> effectue une requête de SELECT avec les lignes spécifiées par le tableau <literal>assoc_array</literal>, au format <literal>champs=>valeur</literal>. Lorsque la requête réussit, <function>pg_select</function> retouren un tableau contenant toutes les lignes et champs qui vérifient la condition spécifiée par <literal>assoc_array</literal>. So <literal>options</literal> st spécifiée, <function>pg_convert</function> est appliquée à <literal>assoc_array</literal> avec l'option spécifiée. </para> <example> <title>Exemple avec <function>pg_select</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); // C'est correct, car $_POST est convertit automatiquement $rec = pg_select($db, 'post_log', $_POST); if ($rec) { echo "Lignes lues\n"; var_dump($rec); } else { echo "Problème dans les données utilisateur\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-send-query.xml +++ phpdoc-fr/reference/pgsql/functions/pg-send-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-send-query"> <refnamediv> <refname>pg_send_query</refname> <refpurpose>Exécute une requête asynchrone</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_send_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>bool</type><methodname>pg_send_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> <function>pg_send_query</function> exécute la requête <parameter>query</parameter> sur la connexion <parameter>connection</parameter>, de manière asynchrone. Contrairement à <function>pg_query</function>, cette fonction permet d'envoyer plusieurs requêtes à un serveur PostgreSQL et de lire les résultats un par un, avec la fonction <function>pg_get_result</function>. L'éxécution du script n'est pas bloquée durant l'exécution de la requête. Utilisez <function>pg_connection_busy</function> pour vérifier si la connexion est encore occupée. Les requêtes peuvent être annulées avec <function>pg_cancel_query</function>. </para> <para> Bien que l'on puiss envoyer plusieurs requêtes en même temps, il n'est pas possible d'envoyer plusieurs requêtes sur une connexion occupée. Si une requête est envoyée alors que la connexion est occupée, elle attendra que la requête précédente soit finie. </para> <para> Voir aussi <function>pg_query</function>, <function>pg_cancel_query</function>, <function>pg_get_result</function> et <function>pg_connection_busy</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-unescape-bytea.xml +++ phpdoc-fr/reference/pgsql/functions/pg-unescape-bytea.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-unescape-bytea"> <refnamediv> <refname>pg_unescape_bytea</refname> <refpurpose>Supprime le protection d'une chaîne de type bytea</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_unescape_bytea</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>pg_unescape_bytea</function> supprime la proctection des caractères de type bytea, mis dans la chaîne <parameter>data</parameter> par la fonction <function>pg_unescape_bytea</function>. La chaîne originale est ainsi retournée. </para> <note> <para> Lorsque vous utilisez une commande SELECT avec des données de type bytea, PostgreSQL retourne des valeurs octales, préfixées avec des anti-slash \ (e.g. \032). Les utilisateurs doivent effectuer la conversion en format binaire eux-même. </para> <para> <function>pg_escape_bytea</function> requiert PostgreSQL 7.2 ou plus récent. Avec PostgreSQL 7.2.0 et 7.2.1, les données de type bytea doivent être transtypée lorsque vous activez le support des chaînes de caractères multi-octets. i.e. <literal>INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);</literal>. PostgreSQL 7.2.2 ou plus récent ne requiert pas cette manipulation. Toutes fois, si le client et le serveur n'utilisent pas le même jeux de caractères, il peut arriver des erreurs. Il faut alors forcer le transtypage manuellement. </para> </note> <para> Voir aussi <function>pg_escape_bytea</function> et <function>pg_escape_string</function> </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-update.xml +++ phpdoc-fr/reference/pgsql/functions/pg-update.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-update"> <refnamediv> <refname>pg_update</refname> <refpurpose>Modifie les lignes d'une table</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>long</type><methodname>pg_update</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>condition</parameter></methodparam> <methodparam><type>array</type><parameter>data</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_update</function> modifie les lignes de la table <parameter>table_name</parameter>, qui vérifient la condition <literal>condition</literal>, et leur donne la valeur de <literal>data</literal>. Si <literal>options</literal> est spécifié, <function>pg_convert</function> est appliqué à <literal>data</literal> avec les options spécifiées. </para> <example> <title>Exemple avec <function>pg_update</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); $data = array('field1'=>'AA', 'field2'=>'BB'); // C'est correct, car $_POST est convertit automatiquement $res = pg_update($db, 'post_log', $_POST, $data); if ($res) { echo "Les données ont été modifiées : $res\n"; } else { echo "Problème dans les données utilisateur\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 -->
Index: phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml diff -u phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml:1.1 phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml:1.2 --- phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml:1.1 Sat Oct 19 14:50:22 2002 +++ phpdoc-fr/reference/pgsql/functions/pg-affected-rows.xml Thu Nov 21 21:31:10 2002 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-affected-rows"> <refnamediv> <refname>pg_affected_rows</refname> - <refpurpose>Retourne le nombre de lignes affectes</refpurpose> + <refpurpose>Retourne le nombre de lignes affectées</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,9 +14,9 @@ </methodsynopsis> <para> <function>pg_affected_rows</function> retourne le nombre de lignes - affectes par les requtes de type INSERT, UPDATE, et DELETE, - excutes par la fonction <function>pg_query</function>. Si aucune - ligne n'a t affecte, <function>pg_affected_rows</function> retourne 0. + affectées par les requêtes de type INSERT, UPDATE, et DELETE, + exécutées par la fonction <function>pg_query</function>. Si aucune + ligne n'a été affectée, <function>pg_affected_rows</function> retourne 0. <example> <title>Exemple avec <function>pg_affected_rows</function></title> <programlisting role="php"> @@ -24,7 +24,7 @@ <?php $result = pg_query($conn, "INSERT INTO editeur VALUES ('Auteur')"); $cmdtuples = pg_affected_rows($result); - echo $cmdtuples . " lignes ont t affectes."; + echo $cmdtuples . " lignes ont été affectées."; ?> ]]> </programlisting> Index: phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml diff -u phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml:1.1 phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml:1.2 --- phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml:1.1 Sat Oct 19 14:50:22 2002 +++ phpdoc-fr/reference/pgsql/functions/pg-field-is-null.xml Thu Nov 21 21:31:11 2002 @@ -19,7 +19,7 @@ &null;. <function>pg_field_is_null</function> retourne 0 si le champs n'est pas &null;. <function>pg_field_is_null</function> retourne 1 si le champs est à &null;. Le champs peut être identifié avec son nom ou - son index numérique (commenant à 0). + son index numérique (commençant à 0). </para> <note> <para> Index: phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml diff -u phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml:1.1 phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml:1.2 --- phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml:1.1 Sat Oct 19 14:50:22 2002 +++ phpdoc-fr/reference/pgsql/functions/pg-num-fields.xml Thu Nov 21 21:31:11 2002 @@ -13,7 +13,7 @@ <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - <function>pg_Num_Fields</function> retourne le nombre de champs + <function>pg_num_fields</function> retourne le nombre de champs (ou colonnes) d'un résultat PostgreSQL. L'argument doit être un identifiant de résultat valide retourné par <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur. Index: phpdoc-fr/reference/pgsql/functions/pg-cancel-query.xml +++ phpdoc-fr/reference/pgsql/functions/pg-cancel-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-cancel-query"> <refnamediv> <refname>pg_cancel_query</refname> <refpurpose>Annule une requête asynchrone</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_cancel_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_cancel_query</function> annule la requête asynchrone, démarrée avec <function>pg_send_query</function>, sur la connexion <parameter>connection</parameter>. Vous ne pouvez pas annuler une requête démarrée avec <function>pg_query</function>. </para> <para> Voir aussi <function>pg_send_query</function> et <function>pg_connection_busy</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-connection-busy.xml +++ phpdoc-fr/reference/pgsql/functions/pg-connection-busy.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-connection-busy"> <refnamediv> <refname>pg_connection_busy</refname> <refpurpose>Vérifie si la connexion est occupée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_connection_busy</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_connection_busy</function> retourne &true; si la connexion est occupe. Si elle est occupée, une requête a déjà été lancée, et est en cours. Si <function>pg_get_result</function> est appelé, elle sera alors bloquée. </para> <para> Voir aussi <function>pg_connection_status</function> et <function>pg_get_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-connection-reset.xml +++ phpdoc-fr/reference/pgsql/functions/pg-connection-reset.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-connection-reset"> <refnamediv> <refname>pg_connection_reset</refname> <refpurpose>Reconnecte au serveur PostGresSQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_connection_reset</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_connection_reset</function> effectue une reconnexion au serveur, avec les mêmes paramètres que lors de la connexion précédente avec <parameter>connection</parameter>. Cette fonction est pratique pour le traitement des erreurs. &return.success; </para> <para> Voir aussi <function>pg_connect</function>, <function>pg_pconnect</function> et <function>pg_connection_status</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-connection-status.xml +++ phpdoc-fr/reference/pgsql/functions/pg-connection-status.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-connection-status"> <refnamediv> <refname>pg_connection_status</refname> <refpurpose>Lit le statut de la connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_connection_status</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_connection_status</function> retourne le statut de la connexion <parameter>connection</parameter>. Les valeurs possibles sont <literal>PGSQL_CONNECTION_OK</literal> (connexion correcte) et <literal>PGSQL_CONNECTION_BAD</literal> (connexion abandonnée). </para> <para> Voir aussi <function>pg_connection_busy</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-convert.xml +++ phpdoc-fr/reference/pgsql/functions/pg-convert.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-convert"> <refnamediv> <refname>pg_convert</refname> <refpurpose>Convertit un tableau associatif en une commande SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_convert</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_convert</function> vérifie et convertit le tableau associatif <literal>assoc_array</literal> en une requête SQL valide. </para> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_metadata</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-copy-from.xml +++ phpdoc-fr/reference/pgsql/functions/pg-copy-from.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-copy-from"> <refnamediv> <refname>pg_copy_from</refname> <refpurpose> Insère des lignes dans une table à partir d'un tableau </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_copy_from</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>rows</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>null_as</parameter></methodparam> </methodsynopsis> <para> <function>pg_copy_from</function> insère les éléments du tableau <parameter>rows</parameter> dans la tableau <parameter>table_name</parameter>. Cette fonction utilise la commande SQL interne <literal>COPY FROM</literal>. &return.success; </para> <para> Voir aussi <function>pg_copy_to</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-copy-to.xml +++ phpdoc-fr/reference/pgsql/functions/pg-copy-to.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-copy-to"> <refnamediv> <refname>pg_copy_to</refname> <refpurpose>Copie une table dans un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_copy_to</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>null_as</parameter></methodparam> </methodsynopsis> <para> <function>pg_copy_to</function> copie la table <parameter>table_name</parameter> dans un tableau, et le retourne. Cette fonction utilise la commande interne SQL <literal>COPY TO</literal> pour insérer les tableaux. En cas d'erreur, la fonction retourne &false;. </para> <para> Voir aussi <function>pg_copy_from</function> </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-delete.xml +++ phpdoc-fr/reference/pgsql/functions/pg-delete.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-delete"> <refnamediv> <refname>pg_delete</refname> <refpurpose>Efface des lignes</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>long</type><methodname>pg_delete</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_delete</function> efface les lignes de la table <parameter>table_name</parameter>, spécfiées par le tableau associatif <literal>assoc_array</literal>, qui est bâti sous la forme <literal>champs=>valeur</literal>. Si <literal>option</literal> est spécifié, <function>pg_convert</function> est appliqué à <literal>assoc_array</literal> avec cette option. </para> <example> <title>Exemple avec <function>pg_delete</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); // C'est sans proble, car $_POST est convertit automatiquement $res = pg_delete($db, 'post_log', $_POST); if ($res) { echo "Les données POSTées ont été effacées : $res\n"; } else { echo "Les données d'entrées sont erronées.\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-escape-bytea.xml +++ phpdoc-fr/reference/pgsql/functions/pg-escape-bytea.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-escape-bytea"> <refnamediv> <refname>pg_escape_bytea</refname> <refpurpose>Protège le caractères d'une chaîne binaire en mode bytea</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_escape_bytea</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>pg_escape_bytea</function> protège les caractères de la chaîne <parameter>data</parameter> avec le mode bytea. La chaîne protégée est retournée. </para> <note> <para> Lorsque vous utilisez une commande SELECT avec des données de type bytea, PostgreSQL retourne des valeurs octales, préfixées avec des anti-slash \ (e.g. \032). Les utilisateurs doivent effectuer la conversion en format binaire eux-même. </para> <para> <function>pg_escape_bytea</function> requiert PostgreSQL 7.2 ou plus récent. Avec PostgreSQL 7.2.0 et 7.2.1, les données de type bytea doivent être transtypée lorsque vous activez le support des chaînes de caractères multi-octets. i.e. <literal>INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);</literal>. PostgreSQL 7.2.2 ou plus récent ne requiert pas cette manipulation. Toutes fois, si le client et le serveur n'utilisent pas le même jeux de caractères, il peut arriver des erreurs. Il faut alors forcer le transtypage manuellement. </para> <para> Les futures versions de PostgreSQL supporteront une fonction de suppression de la protection. L'API &php; évoluera alors. </para> </note> <para> Voir aussi <function>pg_escape_string</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-escape-string.xml +++ phpdoc-fr/reference/pgsql/functions/pg-escape-string.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-escape-string"> <refnamediv> <refname>pg_escape_string</refname> <refpurpose>Protège une chaîne de caractères</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_escape_string</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>pg_escape_string</function> protège la chaîne de caractères <parameter>data</parameter>. Elle retourne la chaîne ainsi protégée. L'utilisation de cette fonction est recommandée, à la place de <function>addslashes</function>. </para> <note> <para> Cette fonction requiert PostgreSQL 7.2 ou plus récent. </para> </note> <para> Voir aussi <function>pg_escape_bytea</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-fetch-all.xml +++ phpdoc-fr/reference/pgsql/functions/pg-fetch-all.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-fetch-all"> <refnamediv> <refname>pg_fetch_all</refname> <refpurpose>Lit toutes les lignes d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_fetch_all</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_all</function> retourne un tableau qui contient toutes les lignes du résultat <parameter>result</parameter>. Elle retourne &false; s'il n'y a plus de lignes disponibles. </para> <para> <example> <title>Exemple avec <function>pg_fetch_all</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } $result = pg_query ($conn, "SELECT * FROM authors"); if (!$result) { echo "Une erreur est survenue.\n"; exit; } $arr = pg_fetch_all ($result, 0, PGSQL_NUM); var_dump($arr); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_fetch_row</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function> et <function>pg_fetch_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-fetch-assoc.xml +++ phpdoc-fr/reference/pgsql/functions/pg-fetch-assoc.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-fetch-assoc"> <refnamediv> <refname>pg_fetch_assoc</refname> <refpurpose>Lit une ligne sous forme de tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_fetch_assoc</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_assoc</function> retourne un tableau associatif qui contient la ligne en cours dans le résultat <parameter>result</parameter>. <function>pg_fetch_assoc</function> retourne &false; si il n'y a plus de lignes. </para> <para> <function>pg_fetch_assoc</function> est une version améliorée de <function>pg_fetch_row</function>. En plus de stocker les valeurs dans un tableau a index numérique, elle stocke aussi les données dans un tableau associatif, en utilisant les noms de colonnes comme index. </para> <para> <parameter>row</parameter> est le numéro de ligne à lire. Par défaut, il vaut 0. </para> <para> <function>pg_fetch_assoc</function> n'est pas significativement plus lente que <function>pg_fetch_row</function>, et elle apporte un confort d'utilisation apréciable. </para> <para> <example> <title>Exemple avec <function>pg_fetch_assoc</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } $result = pg_query ($conn, "SELECT * FROM authors"); if (!$result) { echo "Une erreur est survenue.\n"; exit; } $arr = pg_fetch_assoc ($result, 1, PGSQL_ASSOC); echo $arr["author"] . " <- array\n"; ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_fetch_row</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function> et <function>pg_fetch_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-fetch-result.xml +++ phpdoc-fr/reference/pgsql/functions/pg-fetch-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-fetch-result"> <refnamediv> <refname>pg_fetch_result</refname> <refpurpose>Retourne les valeurs d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>pg_fetch_result</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>row</parameter></methodparam> <methodparam><type>mixed</type><parameter>field</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_result</function> retourne les valeurs stockées dans la ressource de résultat <parameter>result</parameter>, retournée par <function>pg_query</function>. <parameter>row</parameter> est un entier. <parameter>field</parameter> est le nom du champs (sous forme de chaîne) ou un index de colonne (sous forme d'entier). <parameter>row</parameter> et <parameter>field</parameter> spécifie quelles cellules de la table de résultat doivent être lu. Le lignes sont numérotées à partir de 0. Au lieu de nommer le champs, vous pouvez utiliser le numéro de colonne. L'indexation des colonnes commence à 0. </para> <para> PostgreSQL dispose de nombreux types, et seuls les types basiques sont supportés ici. Tous les types <type>integer</type> <!-- FIXME: is that still true? PHP supports boolean&null now... --> <!-- Yes, supporting boolean&null breaks scripts. pg_fetch_array() can be used instead. I might take of this issue with additional ini directive. yohgaki@php.net --> sont retournées sous forme de <type>integer</type>. Tous les types de float, et nombres réels sont retournées sous forme de <type>float</type>. Les booléens sont retournées comme des "t" ou "f". Tous les autres types, y compris les tableaux, sont retournées sous forme de chaînes formatées, de la même manière que PostgreSQL vous les afficherait dans le client <command>psql</command>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-get-notify.xml +++ phpdoc-fr/reference/pgsql/functions/pg-get-notify.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.pg-get-notify"> <refnamediv> <refname>pg_get_notify</refname> <refpurpose>Lit le message de NOTIFY</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_get_notify</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> </methodsynopsis> <para> <function>pg_get_notify</function> reçoit le message de NOTIFY envoyé par une commande SQL <literal>NOTIFY</literal>. Pour lire le message associé, utilisez la commande <literal>LISTEN</literal>. Si il y a un message de notification avec cette connexion, un tableau sera retourné avec le message et le PID du serveur. Si il n'y a pas de message, <function>pg_get_notify</function> retourne &false;. </para> <para> <example> <title>Exemple avec <function>pg_get_notify</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } // coute le message 'author_updated' des autres processus pq_query($conn, 'LISTEN author_updated;'); $notify = pg_get_notify($conn); if (!$notify) print("Aucun message\n"); else print_r($notify); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_get_pid</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-get-pid.xml +++ phpdoc-fr/reference/pgsql/functions/pg-get-pid.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.pg-get-pid"> <refnamediv> <refname>pg_get_pid</refname> <refpurpose>Lit l'identifiant de processus du serveur</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_get_pid</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_get_pid</function> lit l'identifiant de processus du serveur PostGreSQL. Le PID est pratique pour vérifier si un message de <literal>NOTIFY</literal> a été envoyé par un autre processus ou pas. </para> <para> <example> <title>Exemple avec <function>pg_get_pid</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } // PID du serveur. Utilisez alors le PID avec pg_get_notify() $pid = pg_get_pid($conn); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_get_notify</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-get-result.xml +++ phpdoc-fr/reference/pgsql/functions/pg-get-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 --> <refentry id="function.pg-get-result"> <refnamediv> <refname>pg_get_result</refname> <refpurpose>Lit un résultat asynchrone</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>pg_get_result</methodname> <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_get_result</function> lit le résultat asynchrone d'une requête exécutée par <function>pg_send_query</function>. <function>pg_send_query</function> peut envoyer plusieurs requêtes à PostgreSQLet <function>pg_get_result</function> sert à lire les résultats un par un. <function>pg_get_result</function> retourne une ressource de résultat. Si il n'y a pas de résultat, <function>pg_get_result</function> retourne &false;. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-insert.xml +++ phpdoc-fr/reference/pgsql/functions/pg-insert.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-insert"> <refnamediv> <refname>pg_insert</refname> <refpurpose>Insère un tableau dans une table</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_insert</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_insert</function> insère le tableau <literal>assoc_array</literal> (bâtit sur le modèle <literal>champs=>valeur</literal> dans la table <literal>table_name</literal>. Si <literal>options</literal> est spécifié, <function>pg_convert</function> est appliqué à <literal>assoc_array</literal> avec cette option. </para> <example> <title>Exemple avec <function>pg_insert</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); // C'est correct, car $_POST est convertit automatiquement $res = pg_insert($db, 'post_log', $_POST); if ($res) { echo "Les données POSTées ont pu être enregistrée avec succès.\n"; } else { echo "Il y a un problème avec les données.\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-last-error.xml +++ phpdoc-fr/reference/pgsql/functions/pg-last-error.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-last-error"> <refnamediv> <refname>pg_last_error</refname> <refpurpose>Lit le dernier message d'erreur sur la connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_last_error</methodname> <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_error</function> retourne le dernier message d'erreur qui a été enregistré sur la connexion <parameter>connection</parameter>. </para> <para> Les messages d'erreur peuvent être écrasé par des appels internes à l'extension PostgreSQL(libpq) : il se peut que le message retourné ne soit pas approprié, notamment si plusieurs erreurs ont eu lieu dans le module. </para> <para> Utilisez <function>pg_result_error</function>, <function>pg_result_status</function> et <function>pg_connection_status</function> pour améliorer la gestion des erreurs. </para> <note> <para> <function>pg_last_error</function> s'appelait <literal>pg_errormessage()</literal>. </para> </note> <para> Voir aussi <function>pg_result_error</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-last-notice.xml +++ phpdoc-fr/reference/pgsql/functions/pg-last-notice.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-last-notice"> <refnamediv> <refname>pg_last_notice</refname> <refpurpose> Retourne la dernière note du serveur PostgreSQL. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_last_notice</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_notice</function> retourne la dernière note du serveur PostgreSQL, spécifiée par <parameter>connection</parameter>. Le serveur PostgreSQL envoie de snotes dans plusieurs cas, comme par exemple si la transaction ne peut être continuée. Avec <function>pg_last_notice</function>, vous pouvez éviter des requêtes inutiles en vérifiant si des notes liées à votre transaction ont été émises. </para> <warning> <para> Cette fonction est EXPERIMENTAL et elle n'est pas complètement implémentée. <function>pg_last_notice</function> a été ajoutée en PHP 4.0.6. Cependant, PHP 4.0.6 avait un problème avec la gestion des notes. L'utilisation du module PostgreSQL avec PHP 4.0.6 n'est pas recommandé, même si vous n'utilisez pas <function>pg_last_notice</function>. </para> <para> Cette fonction est totaltement implémentée en PHP 4.3.0. Les versions plus ancienne de PHP ignore les données de connexion au serveur. </para> </warning> <para> Le suivi des notes peut être rendu optionnel en mettant à 1 la directive de configuration <literal>pgsql.ignore_notice</literal>, à partir de PHP 4.3.0. </para> <para> L'enregistrement des notes peut être rendu optionnel en mettant la directive de configuration <literal>pgsql.log_notice</literal> à 0, à partir de PHP 4.3.0. A moins que <literal>pgsql.ignore_notice</literal> ne soit à 0, les notes ne seront pas enregistrées. </para> <para> Voir aussi <function>pg_query</function> et <function>pg_last_error</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-last-oid.xml +++ phpdoc-fr/reference/pgsql/functions/pg-last-oid.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-last-oid"> <refnamediv> <refname>pg_last_oid</refname> <refpurpose>Retourne l'identifiant du dernier objet</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_last_oid</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_oid</function> sert à lire le dernier <varname>oid</varname> assigné à un ligne, qui est stocké dans la ressource <parameter>result</parameter>, obtenu lors de la dernière commande <function>pg_query</function>. Il faut que cette commande ait été un INSERT. <function>pg_last_oid</function> retourne un entier positif si il y a eu un <varname>oid</varname> valide. <function>pg_last_oid</function> retourne &false; si une erreur est survenue,, ou si la commande utilisée avec <function>pg_query</function> n'était pas un INSERT, ou que cette commande a échoué. </para> <para> Le champs OID est devenu optionnel depuis PostgreSQL 7.2. Lorsque le champs OID n'est pas défini dans la table, le programmeur doit utiliser <function>pg_result_status</function> pour vérifier si la ligne a été correctement insérée. </para> <note> <para> <function>pg_last_oid</function> s'appelait<literal>pg_getlastoid()</literal>. </para> </note> <para> Voir aussi <function>pg_query</function> et <function>pg_result_status</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-lo-seek.xml +++ phpdoc-fr/reference/pgsql/functions/pg-lo-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-lo-seek"> <refnamediv> <refname>pg_lo_seek</refname> <refpurpose> Modifie la position dans un objet de grande taille </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_lo_seek</methodname> <methodparam><type>resource</type><parameter>large_object</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> </methodsynopsis> <para> <function>pg_lo_seek</function> modifie la position du pointeur dans l'objet de grande taille <parameter>large_object</parameter>. Le paramètre <parameter>whence</parameter> peut prendre les valeurs de <constant>PGSQL_SEEK_SET</constant>, <constant>PGSQL_SEEK_CUR</constant> ou <constant>PGSQL_SEEK_END</constant>. </para> <para> Voir aussi <function>pg_lo_tell</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-lo-tell.xml +++ phpdoc-fr/reference/pgsql/functions/pg-lo-tell.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.74 --> <refentry id="function.pg-lo-tell"> <refnamediv> <refname>pg_lo_tell</refname> <refpurpose>Retourne la position courante dans un objet de grande taille</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_lo_tell</methodname> <methodparam><type>resource</type><parameter>large_object</parameter></methodparam> </methodsynopsis> <para> <function>pg_lo_tell</function> retourne la position courante du pointeur de lecture sur l'objet de grande taille <parameter>large_object</parameter>. C'est le nombre d'octets depuis le dédut du fichier. </para> <para> Voir aussi <function>pg_lo_seek</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-meta-data.xml +++ phpdoc-fr/reference/pgsql/functions/pg-meta-data.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-meta-data"> <refnamediv> <refname>pg_meta_data</refname> <refpurpose>Lit les données méta de la table</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_meta_data</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> </methodsynopsis> <para> <function>pg_meta_data</function> retourne la définition de la table <literal>table_name</literal> sous forme de tableau. Si une erreur survient, <function>pg_meta_data</function> retourne &false;. </para> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-ping.xml +++ phpdoc-fr/reference/pgsql/functions/pg-ping.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-ping"> <refnamediv> <refname>pg_ping</refname> <refpurpose>Pingue la connexion à la base</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_ping</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_ping</function> pingue la connexion à la base de données, et essaie de se reconnecter si la connexion est perdue. <function>pg_ping</function> retourne &true; si la connexion est active, et &false; sinon. </para> <para> <example> <title>Exemple avec <function>pg_ping</function></title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect ("dbname=publisher"); if (!$conn) { echo "Une erreur est survenue.\n"; exit; } if (!pg_ping($conn)) die("La connexion est morte\n"); ?> ]]> </programlisting> </example> </para> <para> Voir aussi <function>pg_connection_status</function> et <function>pg_connection_reset</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-query.xml +++ phpdoc-fr/reference/pgsql/functions/pg-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-query"> <refnamediv> <refname>pg_query</refname> <refpurpose>Exécute une requête</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>pg_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> <function>pg_query</function> retourne une ressource de résultat si la requête a pu être exécutée. Elle retourne &false; en cas d'échec, ou si la connexion n'est pas valide. Le détails sur les erreurs rencontrées est accessible via la fonction <function>pg_last_error</function>, si la connexion est valide. <function>pg_last_error</function> émet une requête SQL au serveur PostgreSQL, spécifé avec le paramètre <parameter>connection</parameter>. <parameter>connection</parameter> doit être une connexion valide, retournée par la fonction <function>pg_connect</function> ou <function>pg_pconnect</function>. La valeur retournée par cette fonction est une ressource de résultat. Pour accéder aux lignes lues, il faudra utiliser les autres fonctions PostgreSQL, telles que <function>pg_fetch_array</function>. <note> <simpara> <parameter>connection</parameter> est un paramètre optionnel de <function>pg_query</function>. Si <parameter>connection</parameter> est omis, la connexion par défaut sera utilisée. La connexion par défaut est la dernière connexion ouverte avec <function>pg_connect</function> ou <function>pg_pconnect</function>. </simpara> <simpara> Bien que <parameter>connection</parameter> puisse être omis, il n'est pas recommandé de le faire, car il peut se révéler difficile de retrouver la connexion dans un script. </simpara> </note> </para> <note> <para> Cette fonction s'appelait <literal>pg_exec()</literal>. <literal>pg_exec()</literal> est toujours disponible pour des raisons de compatibilité, mais les utilisateurs sont encouragés à utiliser le nouveau nom. </para> </note> <para> Voir aussi <function>pg_connect</function>, <function>pg_pconnect</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function>, <function>pg_num_rows</function> et <function>pg_affected_rows</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-result-error.xml +++ phpdoc-fr/reference/pgsql/functions/pg-result-error.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --> <refentry id="function.pg-result-error"> <refnamediv> <refname>pg_result_error</refname> <refpurpose>Lit le message d'erreur associé à un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_result_error</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_error</function> retourne le message d'erreur associé au résultat <parameter>result</parameter>. Par conséquent, l'utilisateur a des chances d'obtenir un message d'erreur plus approprié que via <function>pg_last_error</function>. </para> <para> Voir aussi <function>pg_query</function>, <function>pg_send_query</function>, <function>pg_get_result</function>, <function>pg_last_error</function> et <function>pg_last_notice</function> </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-result-seek.xml +++ phpdoc-fr/reference/pgsql/functions/pg-result-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-result-seek"> <refnamediv> <refname>pg_result_seek</refname> <refpurpose>Modifie la ligne courant dans un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_result_seek</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_seek</function> choisit la ligne <parameter>offset</parameter> comme ligne courante dans le résultat <parameter>result</parameter>. <function>pg_result_seek</function> retourne &false;, en cas d'erreur. </para> <para> Voir aussi <function>pg_fetch_row</function>, <function>pg_fetch_assoc</function>, <function>pg_fetch_array</function>, <function>pg_fetch_object</function> et <function>pg_fetch_result</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-result-status.xml +++ phpdoc-fr/reference/pgsql/functions/pg-result-status.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 --> <refentry id="function.pg-result-status"> <refnamediv> <refname>pg_result_status</refname> <refpurpose>Lit le statut du résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pg_result_status</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_status</function> lit le statut du résultat <parameter>result</parameter>. Les valeurs retournée possibles sont <constant>PGSQL_EMPTY_QUERY</constant>, <constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>, <constant>PGSQL_COPY_TO</constant>, <constant>PGSQL_COPY_FROM</constant>, <constant>PGSQL_BAD_RESPONSE</constant>, <constant>PGSQL_NONFATAL_ERROR</constant> et <constant>PGSQL_FATAL_ERROR</constant>. </para> <para> Voir aussi <function>pg_connection_status</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-select.xml +++ phpdoc-fr/reference/pgsql/functions/pg-select.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-select"> <refnamediv> <refname>pg_select</refname> <refpurpose>Effectue une selection</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>pg_select</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_select</function> effectue une requête de SELECT avec les lignes spécifiées par le tableau <literal>assoc_array</literal>, au format <literal>champs=>valeur</literal>. Lorsque la requête réussit, <function>pg_select</function> retouren un tableau contenant toutes les lignes et champs qui vérifient la condition spécifiée par <literal>assoc_array</literal>. So <literal>options</literal> st spécifiée, <function>pg_convert</function> est appliquée à <literal>assoc_array</literal> avec l'option spécifiée. </para> <example> <title>Exemple avec <function>pg_select</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); // C'est correct, car $_POST est convertit automatiquement $rec = pg_select($db, 'post_log', $_POST); if ($rec) { echo "Lignes lues\n"; var_dump($rec); } else { echo "Problème dans les données utilisateur\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-send-query.xml +++ phpdoc-fr/reference/pgsql/functions/pg-send-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --> <refentry id="function.pg-send-query"> <refnamediv> <refname>pg_send_query</refname> <refpurpose>Exécute une requête asynchrone</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>pg_send_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>bool</type><methodname>pg_send_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> <function>pg_send_query</function> exécute la requête <parameter>query</parameter> sur la connexion <parameter>connection</parameter>, de manière asynchrone. Contrairement à <function>pg_query</function>, cette fonction permet d'envoyer plusieurs requêtes à un serveur PostgreSQL et de lire les résultats un par un, avec la fonction <function>pg_get_result</function>. L'éxécution du script n'est pas bloquée durant l'exécution de la requête. Utilisez <function>pg_connection_busy</function> pour vérifier si la connexion est encore occupée. Les requêtes peuvent être annulées avec <function>pg_cancel_query</function>. </para> <para> Bien que l'on puiss envoyer plusieurs requêtes en même temps, il n'est pas possible d'envoyer plusieurs requêtes sur une connexion occupée. Si une requête est envoyée alors que la connexion est occupée, elle attendra que la requête précédente soit finie. </para> <para> Voir aussi <function>pg_query</function>, <function>pg_cancel_query</function>, <function>pg_get_result</function> et <function>pg_connection_busy</function>. </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-unescape-bytea.xml +++ phpdoc-fr/reference/pgsql/functions/pg-unescape-bytea.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 --> <refentry id="function.pg-unescape-bytea"> <refnamediv> <refname>pg_unescape_bytea</refname> <refpurpose>Supprime le protection d'une chaîne de type bytea</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>pg_unescape_bytea</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para> <function>pg_unescape_bytea</function> supprime la proctection des caractères de type bytea, mis dans la chaîne <parameter>data</parameter> par la fonction <function>pg_unescape_bytea</function>. La chaîne originale est ainsi retournée. </para> <note> <para> Lorsque vous utilisez une commande SELECT avec des données de type bytea, PostgreSQL retourne des valeurs octales, préfixées avec des anti-slash \ (e.g. \032). Les utilisateurs doivent effectuer la conversion en format binaire eux-même. </para> <para> <function>pg_escape_bytea</function> requiert PostgreSQL 7.2 ou plus récent. Avec PostgreSQL 7.2.0 et 7.2.1, les données de type bytea doivent être transtypée lorsque vous activez le support des chaînes de caractères multi-octets. i.e. <literal>INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);</literal>. PostgreSQL 7.2.2 ou plus récent ne requiert pas cette manipulation. Toutes fois, si le client et le serveur n'utilisent pas le même jeux de caractères, il peut arriver des erreurs. Il faut alors forcer le transtypage manuellement. </para> </note> <para> Voir aussi <function>pg_escape_bytea</function> et <function>pg_escape_string</function> </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 --> Index: phpdoc-fr/reference/pgsql/functions/pg-update.xml +++ phpdoc-fr/reference/pgsql/functions/pg-update.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 --> <refentry id="function.pg-update"> <refnamediv> <refname>pg_update</refname> <refpurpose>Modifie les lignes d'une table</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>long</type><methodname>pg_update</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam><type>array</type><parameter>condition</parameter></methodparam> <methodparam><type>array</type><parameter>data</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pg_update</function> modifie les lignes de la table <parameter>table_name</parameter>, qui vérifient la condition <literal>condition</literal>, et leur donne la valeur de <literal>data</literal>. Si <literal>options</literal> est spécifié, <function>pg_convert</function> est appliqué à <literal>data</literal> avec les options spécifiées. </para> <example> <title>Exemple avec <function>pg_update</function></title> <programlisting role="php"> <![CDATA[ <?php $db = pg_connect ('dbname=foo'); $data = array('field1'=>'AA', 'field2'=>'BB'); // C'est correct, car $_POST est convertit automatiquement $res = pg_update($db, 'post_log', $_POST, $data); if ($res) { echo "Les données ont été modifiées : $res\n"; } else { echo "Problème dans les données utilisateur\n"; } ?> ]]> </programlisting> </example> <note> <para> &warn.experimental.func; </para> </note> <para> Voir aussi <function>pg_convert</function>. </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 -->