cvs: peardoc /fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml

From: Date: Tue, 06 Jul 2004 16:18:49 +0000
Subject: cvs: peardoc /fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-4570@lists.php.net to get a copy of this message
yannick Tue Jul 6 12:18:49 2004 EDT Modified files: /peardoc/fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml Log: oops, HTML encoded

http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-portability.xml?r1=1.5&r2=1.6&ty=u Index: peardoc/fr/package/database/db/intro-portability.xml diff -u peardoc/fr/package/database/db/intro-portability.xml:1.5 peardoc/fr/package/database/db/intro-portability.xml:1.6 --- peardoc/fr/package/database/db/intro-portability.xml:1.5 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-portability.xml Tue Jul 6 12:18:49 2004 @@ -1,42 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- EN-Revision: 1.22 Maintainer: didou Status: ready --> <refentry id="package.database.db.intro-portability"> <refnamediv> - <refname>Introduction - Portabilité</refname> - <refpurpose>Portabilité de base de données</refpurpose> + <refname>Introduction - Portabilit&eacute;</refname> + <refpurpose>Portabilit&eacute; de base de donn&eacute;es</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-portability.desc"> &title.desc; <para> - Chaque système de gestion de base de données (DBMS) possède son - propre comportement. Par exemple, quelques base de données mettent + Chaque syst&egrave;me de gestion de base de donn&eacute;es (DBMS) poss&egrave;de son + propre comportement. Par exemple, quelques base de donn&eacute;es mettent les noms des champs en majuscules lors de l'affichage, d'autres les - mettent en minuscule, d'autres encore ne font rien. Ces différences - rendent difficile le portage de scripts d'un type de serveur à un autre. - PEAR DB essaye de s'adapter au mieux pour diminuer ces différences, pour + mettent en minuscule, d'autres encore ne font rien. Ces diff&eacute;rences + rendent difficile le portage de scripts d'un type de serveur &agrave; un autre. + PEAR DB essaye de s'adapter au mieux pour diminuer ces diff&eacute;rences, pour que vos migrations ne soient plus un calvaire. </para> <para> - Vous contrôlez le mode de portabilité en utilisant l'option de configuration + Vous contr&ocirc;lez le mode de portabilit&eacute; en utilisant l'option de configuration <varname>portability</varname>. - Vous définissez ces options en utilisant + Vous d&eacute;finissez ces options en utilisant <link linkend="package.database.db.db.connect"> <function>connect</function></link> et <link linkend="package.database.db.db-common.setoption"> <function>setOption</function></link>. </para> <para> - Les modes de portabilités sont des bits, ils peuvent donc être combinés - en utilisant <literal>|</literal> et supprimés en utilisant <literal>^</literal>. + Les modes de portabilit&eacute;s sont des bits, ils peuvent donc &ecirc;tre combin&eacute;s + en utilisant <literal>|</literal> et supprim&eacute;s en utilisant <literal>^</literal>. Regardez les exemples suivants pour comprendre. </para> </refsect1> <refsect1 id="package.database.db.intro-portability.constants"> - <title>Constantes des modes de portabilité</title> + <title>Constantes des modes de portabilit&eacute;</title> <para> <itemizedlist> @@ -45,7 +45,7 @@ <constant>DB_PORTABILITY_ALL</constant> </para> <para> - active les fonctionnalités de portabilité + active les fonctionnalit&eacute;s de portabilit&eacute; </para> </listitem> @@ -54,11 +54,11 @@ <constant>DB_PORTABILITY_DELETE_COUNT</constant> </para> <para> - force à renvoyer le nombre de lignes supprimées. - Quelques DBMS ne compte pas les lignes effacées lors de l'exécution - de requêtes simples comme <userinput>DELETE FROM nomtable</userinput>. - Ce mode force ces DBMS à renvoyer le nombre en question en ajoutant - <userinput>WHERE 1=1</userinput> à la fin de la requête <command>DELETE</command>. + force &agrave; renvoyer le nombre de lignes supprim&eacute;es. + Quelques DBMS ne compte pas les lignes effac&eacute;es lors de l'ex&eacute;cution + de requ&ecirc;tes simples comme <userinput>DELETE FROM nomtable</userinput>. + Ce mode force ces DBMS &agrave; renvoyer le nombre en question en ajoutant + <userinput>WHERE 1=1</userinput> &agrave; la fin de la requ&ecirc;te <command>DELETE</command>. </para> </listitem> @@ -123,8 +123,8 @@ le pilote MS ODBC fait une erreur en rapportant 'no such field' (aucun champ portant ce nom) avec le code <computeroutput>07001</computeroutput>, qui signifie - 'pas assez de paramètres.' Lorsque cette option est activée, le - code est rectifié. + 'pas assez de param&egrave;tres.' Lorsque cette option est activ&eacute;e, le + code est rectifi&eacute;. </entry> <entry> <constant>DB_ERROR_MISMATCH</constant> @@ -154,10 +154,10 @@ <listitem> <para> - <constant>DB_PORTABILITY_NONE</constant> (défaut) + <constant>DB_PORTABILITY_NONE</constant> (d&eacute;faut) </para> <para> - Désactive les fonctionnalités de portabilité + D&eacute;sactive les fonctionnalit&eacute;s de portabilit&eacute; </para> </listitem> @@ -166,10 +166,10 @@ <constant>DB_PORTABILITY_NULL_TO_EMPTY</constant> </para> <para> - convertit les valeurs nulles en chaînes vides pour les fonctions + convertit les valeurs nulles en cha&icirc;nes vides pour les fonctions <function>get*</function> et <function>fetch*</function>. - Cela est requis car Oracle considère les chaînes vides comme étant - null, alors que la plupart des autres pilotes font la différence entre vide et + Cela est requis car Oracle consid&egrave;re les cha&icirc;nes vides comme &eacute;tant + null, alors que la plupart des autres pilotes font la diff&eacute;rence entre vide et null. </para> </listitem> @@ -188,7 +188,7 @@ <constant>DB_PORTABILITY_RTRIM</constant> </para> <para> - Supprime les espaces blancs de la droite des données renvoyées par + Supprime les espaces blancs de la droite des donn&eacute;es renvoy&eacute;es par <function>get*</function> et <function>fetch*</function> </para> </listitem> @@ -198,12 +198,12 @@ </refsect1> <refsect1 id="package.database.db.intro-portability.compatibility"> - <title>Compatibilité ascendante</title> + <title>Compatibilit&eacute; ascendante</title> <para> - Quelques fonctionnalités étaient supportées par l'option <varname>optimize</varname> - qui est maintenant déconseillée. Pour une compatibilité ascendante, lorsque cette - option est configurée à <literal>portability</literal>, les bases de données suivantes - ont ces modes de portabilité activés : + Quelques fonctionnalit&eacute;s &eacute;taient support&eacute;es par l'option <varname>optimize</varname> + qui est maintenant d&eacute;conseill&eacute;e. Pour une compatibilit&eacute; ascendante, lorsque cette + option est configur&eacute;e &agrave; <literal>portability</literal>, les bases de donn&eacute;es suivantes + ont ces modes de portabilit&eacute; activ&eacute;s : <itemizedlist> <listitem> <para> @@ -221,8 +221,8 @@ </itemizedlist> </para> <para> - Lorsque l'option <varname>optimize</varname> est configurée à la valeur - <literal>performance</literal>, le mode de portabilité est changé en + Lorsque l'option <varname>optimize</varname> est configur&eacute;e &agrave; la valeur + <literal>performance</literal>, le mode de portabilit&eacute; est chang&eacute; en <constant>DB_PORTABILITY_NONE</constant>. </para> </refsect1> @@ -230,7 +230,7 @@ <refsect1 id="package.database.db.intro-portability.example"> &title.example; <example> - <title>Activer toutes les options de portabilité lors de la connexion</title> + <title>Activer toutes les options de portabilit&eacute; lors de la connexion</title> <programlisting role="php"> <![CDATA[ <?php @@ -253,8 +253,8 @@ <example> <title> - Utilisation de <function>setOption</function> pour activer la portabilité - pour le passage en minuscules et le nettoyage des espaces blancs à droite + Utilisation de <function>setOption</function> pour activer la portabilit&eacute; + pour le passage en minuscules et le nettoyage des espaces blancs &agrave; droite </title> <programlisting role="php"> <![CDATA[ @@ -270,7 +270,7 @@ <example> <title> Utilisation de <function>setOption</function> pour activer toutes les - options de portabilité à part le nettoyage des espaces blancs à droite + options de portabilit&eacute; &agrave; part le nettoyage des espaces blancs &agrave; droite </title> <programlisting role="php"> <![CDATA[ http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-query.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-query.xml diff -u peardoc/fr/package/database/db/intro-query.xml:1.3 peardoc/fr/package/database/db/intro-query.xml:1.4 --- peardoc/fr/package/database/db/intro-query.xml:1.3 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-query.xml Tue Jul 6 12:18:49 2004 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> <refentry id="package.database.db.intro-query"> <refnamediv> - <refname>Introduction - Requête</refname> - <refpurpose>Exécuter des requêtes</refpurpose> + <refname>Introduction - Requ&ecirc;te</refname> + <refpurpose>Ex&eacute;cuter des requ&ecirc;tes</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-query.desc"> &title.desc; <para> - PEAR DB fournit plusieurs méthodes pour interroger les bases de données. - La méthode la plus directe est + PEAR DB fournit plusieurs m&eacute;thodes pour interroger les bases de donn&eacute;es. + La m&eacute;thode la plus directe est <link linkend="package.database.db.db-common.query"> <function>query</function></link>. - Il prend en tant que paramètre la requête. + Il prend en tant que param&egrave;tre la requ&ecirc;te. Il y a trois retours possibles : - un nouvel objet &class.db-result; pour les requêtes qui retournent - des résultats (comme les requêtes <command>SELECT</command>), - &constant.db-ok; pour les requêtes qui manipulent des données - (comme les requêtes <command>INSERT</command>) ou un objet + un nouvel objet &class.db-result; pour les requ&ecirc;tes qui retournent + des r&eacute;sultats (comme les requ&ecirc;tes <command>SELECT</command>), + &constant.db-ok; pour les requ&ecirc;tes qui manipulent des donn&eacute;es + (comme les requ&ecirc;tes <command>INSERT</command>) ou un objet &class.db-error; en cas d'erreur. </para> <example> - <title>Exécuter une requête</title> + <title>Ex&eacute;cuter une requ&ecirc;te</title> <programlisting role="php"> <![CDATA[ <?php -// Création d'un objet DB valide nommé $db -// en début de votre programme... +// Cr&eacute;ation d'un objet DB valide nomm&eacute; $db +// en d&eacute;but de votre programme... require_once 'DB.php'; $db =& DB::connect('pgsql://usr:pw@localhost/dbnam'); @@ -38,10 +38,10 @@ die($db->getMessage()); } -// Exécution de la requête +// Ex&eacute;cution de la requ&ecirc;te $res =& $db->query('SELECT * FROM clients'); -// Vérifiez toujours que $res n'est pas une erreur +// V&eacute;rifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die($res->getMessage()); } @@ -51,16 +51,16 @@ </example> <para> - <function>query</function> peut être utilisée à la place de + <function>query</function> peut &ecirc;tre utilis&eacute;e &agrave; la place de <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link> et <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link>, si vous utilisez le paramètre + <function>execute</function></link>, si vous utilisez le param&egrave;tre <parameter>$params</parameter> et que vous posissionnez vos marqueurs. </para> <example> - <title>Utiliser une requête en mode prepare/execute avec un paramètre scalaire</title> + <title>Utiliser une requ&ecirc;te en mode prepare/execute avec un param&egrave;tre scalaire</title> <programlisting role="php"> <![CDATA[ <?php @@ -70,7 +70,7 @@ $res =& $db->query($sql, $data); -// Vérifiez toujours que $res n'est pas une erreur +// V&eacute;rifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die($res->getMessage()); } @@ -80,7 +80,7 @@ </example> <example> - <title>Utiliser une requête en mode prepare/execute avec un tableau en paramètre</title> + <title>Utiliser une requ&ecirc;te en mode prepare/execute avec un tableau en param&egrave;tre</title> <programlisting role="php"> <![CDATA[ <?php @@ -90,7 +90,7 @@ $res =& $db->query($sql, $data); -// Vérifiez toujours que $res n'est pas une erreur +// V&eacute;rifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die ($res->getMessage()); } http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-sequences.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/fr/package/database/db/intro-sequences.xml diff -u peardoc/fr/package/database/db/intro-sequences.xml:1.4 peardoc/fr/package/database/db/intro-sequences.xml:1.5 --- peardoc/fr/package/database/db/intro-sequences.xml:1.4 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-sequences.xml Tue Jul 6 12:18:49 2004 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- EN-Revision: 1.18 Maintainer: didou Status: ready --> <refentry id="package.database.db.intro-sequences"> <refnamediv> - <refname>Introduction - Séquences</refname> - <refpurpose>Séquences et auto-incrémentation</refpurpose> + <refname>Introduction - S&eacute;quences</refname> + <refpurpose>S&eacute;quences et auto-incr&eacute;mentation</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-sequences.desc"> &title.desc; <para> - Les séquences sont une façon d'offrir des identifiants + Les s&eacute;quences sont une fa&ccedil;on d'offrir des identifiants uniques pour les enregistrements. Si vous travaillez principalement - avec MySQL, pensez que les séquences sont une autre façon - de réaliser la tâche d'<command>AUTO_INCREMENT</command>. + avec MySQL, pensez que les s&eacute;quences sont une autre fa&ccedil;on + de r&eacute;aliser la t&acirc;che d'<command>AUTO_INCREMENT</command>. </para> <para> C'est relativement simple, d'abord vous demandez un identifiant et vous - insérez sa valeur dans le champ ID du nouvel enregistrement que vous - créez. Vous pouvez avoir plus d'une séquence pour toutes vos - tables, soyez juste sûrs de toujours utiliser la même - séquence pour une table donnée. Pour obtenir la valeur de + ins&eacute;rez sa valeur dans le champ ID du nouvel enregistrement que vous + cr&eacute;ez. Vous pouvez avoir plus d'une s&eacute;quence pour toutes vos + tables, soyez juste s&ucirc;rs de toujours utiliser la m&ecirc;me + s&eacute;quence pour une table donn&eacute;e. Pour obtenir la valeur de l'identifiant unique utilisez <link linkend="package.database.db.db-common.nextid"><function>nextId</function></link>, - si une séquence n'existe pas elle sera créée automatiquement. + si une s&eacute;quence n'existe pas elle sera cr&eacute;&eacute;e automatiquement. <example> - <title>Utiliser une séquence</title> + <title>Utiliser une s&eacute;quence</title> <programlisting role="php"> <![CDATA[ <?php -// On suppose que vous avec un objet DB valide nommé $db +// On suppose que vous avec un objet DB valide nomm&eacute; $db $id = $db->nextId('mySequence'); if (DB::isError($id)) { die($id->getMessage()); } -// Utilisez l'identifiant dans votre requête +// Utilisez l'identifiant dans votre requ&ecirc;te $res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')"); ?> ]]> @@ -50,17 +50,17 @@ <refsect1 id="package.database.db.intro-sequences.note"> &title.note; <para> - Si vous avez besoin d'accéder manuellement aux objets base de données - que PEAR DB utilise pour stocker les informations d'une séquence, sachez - que les objets sont nommés en passant l'argument <parameter>$seq_name</parameter> - que vous fournissez aux méthode de séquences PEAR DB via la fonction + Si vous avez besoin d'acc&eacute;der manuellement aux objets base de donn&eacute;es + que PEAR DB utilise pour stocker les informations d'une s&eacute;quence, sachez + que les objets sont nomm&eacute;s en passant l'argument <parameter>$seq_name</parameter> + que vous fournissez aux m&eacute;thode de s&eacute;quences PEAR DB via la fonction PHP <function>sprintf</function> en utilisant la valeur de l'option <varname>seqname_format</varname> en tant qu'argument de format de <function>sprintf</function>. </para> <para> - Le <varname>seqname_format</varname> par défaut est <literal>%s_seq</literal>, - qui peut être changé lors de la connexion avec + Le <varname>seqname_format</varname> par d&eacute;faut est <literal>%s_seq</literal>, + qui peut &ecirc;tre chang&eacute; lors de la connexion avec <link linkend="package.database.db.db.connect"> <function>connect</function></link> ou via <link linkend="package.database.db.db-common.setoption">
« previous php.pear.doc (#4570) next »