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

From: Date: Tue, 06 Jul 2004 16:16: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-4569@lists.php.net to get a copy of this message
yannick Tue Jul 6 12:16:49 2004 EDT Modified files: /peardoc/fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml Log: sync with EN revision

http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-portability.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/fr/package/database/db/intro-portability.xml diff -u peardoc/fr/package/database/db/intro-portability.xml:1.4 peardoc/fr/package/database/db/intro-portability.xml:1.5 --- peardoc/fr/package/database/db/intro-portability.xml:1.4 Fri Mar 5 12:57:12 2004 +++ peardoc/fr/package/database/db/intro-portability.xml Tue Jul 6 12:16:49 2004 @@ -1,86 +1,64 @@ -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.11 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.22 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-portability"> <refnamediv> - <refname>Introduction - Portabilit&eacute;</refname> - <refpurpose>Portabilit&eacute; de base de donn&eacute;es</refpurpose> + <refname>Introduction - Portabilité</refname> + <refpurpose>Portabilité de base de données</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-portability.desc"> &title.desc; <para> - 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 + Chaque système de gestion de base de données (DBMS) possède son + propre comportement. Par exemple, quelques base de donné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&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 + 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 que vos migrations ne soient plus un calvaire. </para> <para> - vous contr&ocirc;lez le mode de portabilit&eacute; &agrave; utiliser en utilisant + Vous contrôlez le mode de portabilité en utilisant l'option de configuration + <varname>portability</varname>. + Vous définissez ces options en utilisant <link linkend="package.database.db.db.connect"> - <function>connect</function></link> et + <function>connect</function></link> et <link linkend="package.database.db.db-common.setoption"> - <function>setOption</function></link>. + <function>setOption</function></link>. </para> <para> - 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>. + 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>. Regardez les exemples suivants pour comprendre. </para> </refsect1> <refsect1 id="package.database.db.intro-portability.constants"> - <title>Constantes des modes de portabilit&eacute;</title> + <title>Constantes des modes de portabilité</title> <para> <itemizedlist> + <listitem> <para> - <constant>DB_PORTABILITY_NONE</constant> (d&eacute;faut) - </para> - <para> - d&eacute;sactiv&eacute; les fonctionnalit&eacute;s de portabilit&eacute; - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_LOWERCASE</constant> - </para> - <para> - convertit le nom des tables et des champs en minuscules lors de - l'utilisation de <function>get*</function>, <function>fetch*</function> et - <function>tableInfo</function> - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_RTRIM</constant> + <constant>DB_PORTABILITY_ALL</constant> </para> <para> - Supprime les espaces blancs de la droite des donn&eacute;es renvoy&eacute;es par - <function>get*</function> et <function>fetch*</function> + active les fonctionnalités de portabilité </para> </listitem> + <listitem> <para> <constant>DB_PORTABILITY_DELETE_COUNT</constant> </para> <para> - 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 <literal>DELETE FROM nomtable</literal>. - Ce mode force ces DBMS &agrave; renvoyer le nombre en question en ajoutant - <literal>WHERE 1=1</literal> &agrave; la fin de la requ&ecirc;te <literal>DELETE</literal> - queries. - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_NUMROWS</constant> - </para> - <para> - active un script qui fait fonctionner <function>numRows</function> avec Oracle + 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>. </para> </listitem> @@ -89,7 +67,7 @@ <constant>DB_PORTABILITY_ERRORS</constant> </para> <para> - rend les messages d'erreurs de certains pilotes compatible avec les + rend les messages d'erreurs de certains pilotes compatibles avec les messages des autres serveurs </para> <para> @@ -145,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&egrave;tres.' Lorsque cette option est activ&eacute;e, le - code est rectifi&eacute;. + 'pas assez de paramètres.' Lorsque cette option est activée, le + code est rectifié. </entry> <entry> <constant>DB_ERROR_MISMATCH</constant> @@ -165,22 +143,53 @@ <listitem> <para> + <constant>DB_PORTABILITY_LOWERCASE</constant> + </para> + <para> + convertit le nom des tables et des champs en minuscules lors de + l'utilisation de <function>get*</function>, <function>fetch*</function> et + <function>tableInfo</function> + </para> + </listitem> + + <listitem> + <para> + <constant>DB_PORTABILITY_NONE</constant> (défaut) + </para> + <para> + Désactive les fonctionnalités de portabilité + </para> + </listitem> + + <listitem> + <para> <constant>DB_PORTABILITY_NULL_TO_EMPTY</constant> </para> <para> - convertit les valeurs nulles en cha&icirc;nes vides pour les fonctions get*() - et fetch*(). 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 + convertit les valeurs nulles en chaî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 null. </para> </listitem> + + <listitem> + <para> + <constant>DB_PORTABILITY_NUMROWS</constant> + </para> + <para> + active un script qui fait fonctionner <function>numRows</function> avec Oracle + </para> + </listitem> <listitem> <para> - <constant>DB_PORTABILITY_ALL</constant> + <constant>DB_PORTABILITY_RTRIM</constant> </para> <para> - active toutes les fonctionnalit&eacute;s de portabilit&eacute; + Supprime les espaces blancs de la droite des données renvoyées par + <function>get*</function> et <function>fetch*</function> </para> </listitem> @@ -189,12 +198,12 @@ </refsect1> <refsect1 id="package.database.db.intro-portability.compatibility"> - <title>Compatibilit&eacute; ascendante</title> + <title>Compatibilité ascendante</title> <para> - Quelques fonctionnalit&eacute;s &eacute;taient support&eacute;es par l'option <literal>optimize</literal> - 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 : + 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 : <itemizedlist> <listitem> <para> @@ -212,17 +221,18 @@ </itemizedlist> </para> <para> - Lorsque l'option <literal>optimize</literal> est configur&eacute;e &agrave; la valeur - <literal>performance</literal>, le mode de portabilit&eacute; est chang&eacute; en + Lorsque l'option <varname>optimize</varname> est configurée à la valeur + <literal>performance</literal>, le mode de portabilité est changé en <constant>DB_PORTABILITY_NONE</constant>. </para> </refsect1> + <refsect1 id="package.database.db.intro-portability.example"> &title.example; <example> - <title>Activer toutes les options de portabilit&eacute; lors de la connexion</title> + <title>Activer toutes les options de portabilité lors de la connexion</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php require_once 'DB.php'; @@ -234,19 +244,20 @@ $db =& DB::connect($dsn, $options); if (DB::isError($db)) { - die($db->getMessage()); + die($db->getMessage()); } ?> ]]> </programlisting> </example> + <example> <title> - Utilisation de <function>setOption</function> pour activer la portabilit&eacute; - pour le passage en minuscules et le nettoyage des espaces blancs &agrave; droite + Utilisation de <function>setOption</function> pour activer la portabilité + pour le passage en minuscules et le nettoyage des espaces blancs à droite </title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $db->setOption('portability', @@ -255,13 +266,14 @@ ]]> </programlisting> </example> + <example> <title> Utilisation de <function>setOption</function> pour activer toutes les - options de portabilit&eacute; &agrave; part le nettoyage des espaces blancs &agrave; droite + options de portabilité à part le nettoyage des espaces blancs à droite </title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $db->setOption('portability', http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-query.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/intro-query.xml diff -u peardoc/fr/package/database/db/intro-query.xml:1.2 peardoc/fr/package/database/db/intro-query.xml:1.3 --- peardoc/fr/package/database/db/intro-query.xml:1.2 Fri Feb 20 10:54:33 2004 +++ peardoc/fr/package/database/db/intro-query.xml Tue Jul 6 12:16:49 2004 @@ -1,86 +1,99 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.13 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-query"> <refnamediv> - <refname>Introduction - Requ&ecirc;te</refname> - <refpurpose>Ex&eacute;cuter des requ&ecirc;tes</refpurpose> + <refname>Introduction - Requête</refname> + <refpurpose>Exécuter des requêtes</refpurpose> </refnamediv> + <refsect1 id="package.database.db.intro-query.desc"> &title.desc; - <simpara> - Pour ex&eacute;cuter une requ&ecirc;te sur une base de donn&eacute;es, vous devez utiliser - la fonction <link linkend="package.database.db.db-common.query"> - <function>query</function></link>, qui prend en param&egrave;tre la requ&ecirc;te. - En cas d'erreurs, vous obtiendrez un objet <link - linkend="package.database.db.db-error">&class.db-error;</link>, - v&eacute;rifiez le avec <link linkend="package.database.db.db.iserror"> - <function>DB::isError</function></link>. En cas de succ&egrave;s, vous obtiendrez - en retour &constant.db-ok; ou un objet <link linkend="package.database.db.db-result"> - &class.db-result;</link> si vous avez ex&eacute;cut&eacute; une requ&ecirc;te de type SELECT. - </simpara> + <para> + PEAR DB fournit plusieurs méthodes pour interroger les bases de données. + La mé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 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 + &class.db-error; en cas d'erreur. + </para> + <example> - <title>Ex&eacute;cuter une requ&ecirc;te</title> + <title>Exécuter une requête</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php -// On suppose que vous avez un objet $db valide... -$sql = "select * from clients"; +// Création d'un objet DB valide nommé $db +// en début de votre programme... +require_once 'DB.php'; + +$db =& DB::connect('pgsql://usr:pw@localhost/dbnam'); +if (DB::isError($db)) { + die($db->getMessage()); +} -$result =& $db->query($sql); +// Exécution de la requête +$res =& $db->query('SELECT * FROM clients'); -// V&eacute;rifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die($res->getMessage()); } -.... ?> ]]> </programlisting> </example> + <para> - <function>query</function> peut &ecirc;tre utilis&eacute;e &agrave; la place de + <function>query</function> peut être utilisée à 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&egrave;tre - <parameter>$params</parameter> et que vous posisionnez vos marqueurs. + <function>execute</function></link>, si vous utilisez le paramètre + <parameter>$params</parameter> et que vous posissionnez vos marqueurs. </para> + <example> - <title>Utiliser une requ&ecirc;te en mode prepare/execute avec un param&egrave;tre scalaire</title> + <title>Utiliser une requête en mode prepare/execute avec un paramètre scalaire</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $sql = 'select * from clients where clientid = ?'; $data = 53; -$result =& $db->query($sql, $data); +$res =& $db->query($sql, $data); -// V&eacute;rifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die($res->getMessage()); } -.... ?> ]]> </programlisting> </example> + <example> - <title>Utiliser une requ&ecirc;te en mode prepare/execute avec un tableau en param&egrave;tre</title> + <title>Utiliser une requête en mode prepare/execute avec un tableau en paramètre</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $sql = 'select * from clients where clientid = ? and statusid = ?'; $data = array(53, 4); -$result =& $db->query($sql, $data); +$res =& $db->query($sql, $data); -// V&eacute;rifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die ($res->getMessage()); } -.... ?> ]]> </programlisting> http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-sequences.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-sequences.xml diff -u peardoc/fr/package/database/db/intro-sequences.xml:1.3 peardoc/fr/package/database/db/intro-sequences.xml:1.4 --- peardoc/fr/package/database/db/intro-sequences.xml:1.3 Sat Feb 21 21:56:26 2004 +++ peardoc/fr/package/database/db/intro-sequences.xml Tue Jul 6 12:16:49 2004 @@ -1,77 +1,84 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.18 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-sequences"> - <refnamediv> - <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&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&eacute;quences sont une autre fa&ccedil;on - de r&eacute;aliser la t&acirc;che d'<constant>AUTO_INCREMENT</constant>. - </para> - <para> - C'est relativement simple, d'abord vous demandez un identifiant et vous - 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&eacute;quence n'existe pas elle sera cr&eacute;&eacute;e automatiquement. - <example> - <title>Utiliser une s&eacute;quence</title> - <programlisting role="php"> - <![CDATA[ + <refnamediv> + <refname>Introduction - Séquences</refname> + <refpurpose>Séquences et auto-incré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 + 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>. + </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 + 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. + + <example> + <title>Utiliser une séquence</title> + <programlisting role="php"> +<![CDATA[ <?php -// On suppose que vous avec un objet DB valide nomm&eacute; $db +// On suppose que vous avec un objet DB valide nommé $db $id = $db->nextId('mySequence'); +if (DB::isError($id)) { + die($id->getMessage()); +} -// Utilisez l'identifiant dans votre requ&ecirc;te -$res =& $db->query("INSERT INTO myTable (id,text) VALUES ($id,'foo')"); +// Utilisez l'identifiant dans votre requête +$res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')"); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - - <refsect1 id="package.database.db.intro-sequences.note"> - &title.note; - <para> - 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&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"> - <function>setOption</function></link>. - </para> - </refsect1> + </programlisting> + </example> + </para> + </refsect1> - <refsect1 id="package.database.db.intro-sequences.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.createsequence"> - <function>createSequence</function></link>, - <link linkend="package.database.db.db-common.nextid"> - <function>nextId</function></link>, - <link linkend="package.database.db.db-common.dropsequence"> - <function>dropSequence</function></link> - </para> - </refsect1> + <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 + 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 + <link linkend="package.database.db.db.connect"> + <function>connect</function></link> ou via + <link linkend="package.database.db.db-common.setoption"> + <function>setOption</function></link>. + </para> + </refsect1> + <refsect1 id="package.database.db.intro-sequences.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.createsequence"> + <function>createSequence</function></link>, + <link linkend="package.database.db.db-common.nextid"> + <function>nextId</function></link>, + <link linkend="package.database.db.db-common.dropsequence"> + <function>dropSequence</function></link> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.pear.doc (#4569) next »