cvs: peardoc /fr/package/caching cache-lite.xml /fr/package/caching/cache-lite intro.xml /fr/package/caching/cache-lite/cache-lite-output
cache_lite_output.xml end.xml start.xml /fr/package/database/db-dataobject intro-autobuilding.xml intro-configuration.xml /fr/package/database/db/db
iserror.xml /fr/package/database/db/db-result fetchinto.xml numrows.xml
| From: | Yannick Torres | Date: | Sat, 17 Dec 2005 17:25:32 +0000 |
| Subject: | cvs: peardoc /fr/package/caching cache-lite.xml /fr/package/caching/cache-lite intro.xml /fr/package/caching/cache-lite/cache-lite-output cache_lite_output.xml end.xml start.xml /fr/package/database/db-dataobject intro-autobuilding.xml intro-configuration.xml /fr/package/database/db/db iserror.xml /fr/package/database/db/db-result fetchinto.xml numrows.xml |
||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-7326@lists.php.net to get a copy of this message | ||
yannick Sat Dec 17 17:25:32 2005 EDT
Modified files:
/peardoc/fr/package/caching/cache-lite/cache-lite-output
cache_lite_output.xml
end.xml
start.xml
/peardoc/fr/package/caching/cache-lite intro.xml
/peardoc/fr/package/caching cache-lite.xml
/peardoc/fr/package/database/db-dataobject intro-autobuilding.xml
intro-configuration.xml
/peardoc/fr/package/database/db/db iserror.xml
/peardoc/fr/package/database/db/db-result fetchinto.xml numrows.xml
Log:
sync with EN & some WS
http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml diff -u peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml:1.3 peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml:1.4 --- peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml:1.3 Sun Jun 12 19:56:36 2005 +++ peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml Sat Dec 17 17:25:32 2005 @@ -1,274 +1,315 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="package.default.cache-lite.cache-lite-output.cache-lite-output"> - <refnamediv> - <refname>constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></refname> - <refpurpose>Constructeur</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcsynopsisinfo> - require_once 'LiteOutput.php'; - </funcsynopsisinfo> - <funcprototype> - <funcdef>void constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></funcdef> - <paramdef>array <parameter>$options</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> + <refnamediv> + <refname>constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></refname> + <refpurpose>Constructeur</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + <funcsynopsisinfo> + require_once 'Cache/Lite/Output.php'; + </funcsynopsisinfo> + <funcprototype> + <funcdef>void constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></funcdef> + <paramdef>array <parameter>$options</parameter></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.desc"> + &title.desc; + <para> + Le constructeur de la classe Cache_Lite_Output. Vous pouvez passer un tableau associatif + comme argument pour définir beaucoup d'options. + </para> + </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.desc"> - &title.desc; - <para> - Le constructeur de la classe Cache_Lite_Output. Vous pouvez passer un tableau associatif - comme argument pour définir beaucoup d'options. - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.param"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - - - &type.array; - <parameter>$options</parameter> - </term> - <listitem> - <para> - tableau associatif pour définir beaucoup d'options - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - <table> - <title></title> - <tgroup cols="4"> - <thead> - <row> - <entry>Options</entry> - <entry>Type de données</entry> - <entry>Valeur par défaut</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry> - cacheDir - </entry> - <entry> - &type.string; - </entry> - <entry> - /tmp/ - </entry> - <entry> - dossier où seront stockés les fichier de cache (avec un slash final) - </entry> - </row> - <row> - <entry> - caching - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive le cache - </entry> - </row> - <row> - <entry> - lifeTime - </entry> - <entry> - &type.int; - </entry> - <entry> - 3600 - </entry> - <entry> - durée de vie du cache en seconde - </entry> - </row> - <row> - <entry> - fileLocking - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive les verrous de fichiers (peut - éviter des corruptions de cache dans de mauvaises circonstances) - </entry> - </row> - <row> - <entry> - writeControl - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive le contrôle d'écriture (l'activation du contrôle d'écriture - ralentie un peu l'écriture du cache mais l'inflût pas sur la lecture ; - le contrôle d'écriture peut détecter quelques fichiers de cache - corrumpus mais cependant, ce n'est pas un contrôle parfait) - </entry> - </row> - <row> - <entry> - readControl - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive le contrôle de lecture (si activé, une clé de contrôle est - incluse dans le fichier de cache et cette clé est comparé avec celle calculé - après la lecture) - </entry> - </row> - <row> - <entry> - readControlType - </entry> - <entry> - &type.string; - </entry> - <entry> - crc32 - </entry> - <entry> - Type de contrôle de lecture (uniquement si le contrôle de lecture est activé). - Doit être 'MD5' (pour un contrôle de hash MD5 (le meilleur mais lent)), - 'crc32' (pour un contrôle de hash crc32 (un peu moins sécurisé mais rapide)) ou - 'srtlen' (pour un test de longueur uniquement (très rapide)). - </entry> - </row> - <row> - <entry> - pearErrorMode - </entry> - <entry> - &type.int; - </entry> - <entry> - CACHE_LITE_ERROR_RETURN - </entry> - <entry> - mode d'erreur PEAR (lorsque raiseError est appelé ) (CACHE_LITE_ERROR_RETURN - pour uniquement retourner un objet PEAR_Error ou CACHE_LITE_ERROR_DIE - pour stopper immédiatement le script (idéal pour le débogage)). - </entry> - </row> - <row> - <entry> - fileNameProtection - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - Protection du nom de fichier (si définie à TRUE, vous pouvez utiliser - n'importe quelle identifiant ou nom de groupe, si définie à FALSE, la - rapidité est accrue mais les identifiants de cache et les noms de groupe - seront utilisés directement dans le nom du fichier de cache donc, - attention avecles caractères spéciaux...) - </entry> - </row> - <row> - <entry> - automaticSerialization - </entry> - <entry> - &type.bool; - </entry> - <entry> - &false; - </entry> - <entry> - active / désactive la linéarisation automatique (peut être utilisé pour sauvegarder - directement les données qui ne sont pas des chaînes de caractères mais celà - ralentie le processus) - </entry> - </row> - <row> - <entry> - memoryCaching - </entry> - <entry> - &type.bool; - </entry> - <entry> - &false; - </entry> - <entry> - [BETA QUALITY] active / désactive "Cache en mémoire" - (NB : il n'y pas de durée de vie pour le cache en mémoire, uniquement en fin de script) - </entry> - </row> - <row> - <entry> - onlyMemoryCaching - </entry> - <entry> - &type.bool; - </entry> - <entry> - &false; - </entry> - <entry> - [BETA QUALITY] active / désactive "Cache en mémoire uniquement" - (si activé, les fichiers ne sont pas du tout utilisés) - </entry> - </row> - <row> - <entry> - memoryCachingLimit - </entry> - <entry> - &type.int; - </entry> - <entry> - 1000 - </entry> - <entry> - [BETA QUALITY] le nombre maximal d'enregistrements pouvant - être stockés en cache mémoire. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.param"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.array; + <parameter>$options</parameter> + </term> + <listitem> + <para> + tableau associatif pour définir beaucoup d'options + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + <table> + <title></title> + <tgroup cols="4"> + <thead> + <row> + <entry>Options</entry> + <entry>Type de données</entry> + <entry>Valeur par défaut</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + cacheDir + </entry> + <entry> + &type.string; + </entry> + <entry> + /tmp/ + </entry> + <entry> + dossier où seront stockés les fichier de cache (avec un slash final) + </entry> + </row> + <row> + <entry> + caching + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive le cache + </entry> + </row> + <row> + <entry> + lifeTime + </entry> + <entry> + &type.int; + </entry> + <entry> + 3600 + </entry> + <entry> + durée de vie du cache en seconde (depuis 1.6.0beta1, vous pouvez utiliser une valeur nulle pour + obtenir un cache éternel) + </entry> + </row> + <row> + <entry> + fileLocking + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive les verrous de fichiers (peut + éviter des corruptions de cache dans de mauvaises circonstances) + </entry> + </row> + <row> + <entry> + writeControl + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive le contrôle d'écriture (l'activation du contrôle d'écriture + ralentie un peu l'écriture du cache mais l'inflût pas sur la lecture ; + le contrôle d'écriture peut détecter quelques fichiers de cache + corrumpus mais cependant, ce n'est pas un contrôle parfait) + </entry> + </row> + <row> + <entry> + readControl + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive le contrôle de lecture (si activé, une clé de contrôle est + incluse dans le fichier de cache et cette clé est comparé avec celle calculé + après la lecture) + </entry> + </row> + <row> + <entry> + readControlType + </entry> + <entry> + &type.string; + </entry> + <entry> + crc32 + </entry> + <entry> + Type de contrôle de lecture (uniquement si le contrôle de lecture est activé). + Doit être 'MD5' (pour un contrôle de hash MD5 (le meilleur mais lent)), + 'crc32' (pour un contrôle de hash crc32 (un peu moins sécurisé mais rapide)) ou + 'srtlen' (pour un test de longueur uniquement (très rapide)). + </entry> + </row> + <row> + <entry> + pearErrorMode + </entry> + <entry> + &type.int; + </entry> + <entry> + CACHE_LITE_ERROR_RETURN + </entry> + <entry> + mode d'erreur PEAR (lorsque raiseError est appelé ) (CACHE_LITE_ERROR_RETURN + pour uniquement retourner un objet PEAR_Error ou CACHE_LITE_ERROR_DIE + pour stopper immédiatement le script (idéal pour le débogage)). + </entry> + </row> + <row> + <entry> + fileNameProtection + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + Protection du nom de fichier (si définie à TRUE, vous pouvez utiliser + n'importe quelle identifiant ou nom de groupe, si définie à FALSE, la + rapidité est accrue mais les identifiants de cache et les noms de groupe + seront utilisés directement dans le nom du fichier de cache donc, + attention avecles caractères spéciaux...) + </entry> + </row> + <row> + <entry> + automaticSerialization + </entry> + <entry> + &type.bool; + </entry> + <entry> + &false; + </entry> + <entry> + active / désactive la linéarisation automatique (peut être utilisé pour sauvegarder + directement les données qui ne sont pas des chaînes de caractères mais celà + ralentie le processus) + </entry> + </row> + <row> + <entry> + memoryCaching + </entry> + <entry> + &type.bool; + </entry> + <entry> + &false; + </entry> + <entry> + active / désactive "Cache en mémoire" + (NB : il n'y pas de durée de vie pour le cache en mémoire, uniquement en fin de script) + </entry> + </row> + <row> + <entry> + onlyMemoryCaching + </entry> + <entry> + &type.bool; + </entry> + <entry> + &false; + </entry> + <entry> + active / désactive "Cache en mémoire uniquement" + (si activé, les fichiers ne sont pas du tout utilisés) + </entry> + </row> + <row> + <entry> + memoryCachingLimit + </entry> + <entry> + &type.int; + </entry> + <entry> + 1000 + </entry> + <entry> + le nombre maximal d'enregistrements pouvant + être stockés en cache mémoire. + </entry> + </row> + <row> + <entry> + automaticCleaningFactor + </entry> + <entry> + &type.int; + </entry> + <entry> + 0 + </entry> + <entry> + Désactive / personnalise le processus de nettoyage automatique. + Le processus de nettoyage automatique détruit les fichiers de cache + trop anciens (pour une durée de cache donnée) lorsqu'un nouveau + fichier de cache est écrit. 0 signifie "aucun nettoyage de cache automatique", + 1 signifie "nettoyage du cache systèmatique" (lent), x>1 signifie + "nettoyage automatique 1 fois tous les x fichiers de cache écrits". Une valeur + entre 20 et 200 est surement un bon début. + </entry> + </row> + <row> + <entry> + hashedDirectoryLevel + </entry> + <entry> + &type.int; + </entry> + <entry> + 0 + </entry> + <entry> + Définit le degré de structure du dossiers de hashage. 0 signifie + "aucune structure de dossiers de hashage", 1 signifie "un degré de dossier", + 2 signifie "deux degrés"...Cette option peut améliorer la vitesse de Cache_Lite + uniquement lorsque vous avez plusieurs centaines de fichiers de cache. + La seule solution pour connaître la bonne valeur pour votre cas est de faire + des tests en situation réelle. Peut-être qu'1 ou 2 est un bon début. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.note"> - &title.note; - ¬e.notstatic; - </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.note"> + &title.note; + ¬e.notstatic; + </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -287,4 +328,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml?r1=1.2&r2=1.3&diff_format=u Index: peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml diff -u peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml:1.2 peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml:1.3 --- peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml:1.2 Sun Jul 25 15:13:42 2004 +++ peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml Sat Dec 17 17:25:32 2005 @@ -1,39 +1,42 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="package.default.cache-lite.cache-lite-output.end"> - <refnamediv> - <refname><function>Cache_Lite_Output::end</function></refname> - <refpurpose>Stoppe la beufferisation de la sortie, démarrer par la méthode start() - et stocke la sortie dans un fichier de cache</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcsynopsisinfo> - require_once 'LiteOutput.php'; - </funcsynopsisinfo> - <funcprototype> - <funcdef>void <function>Cache_Lite_Output::end</function></funcdef> -<paramdef></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - - <refsect1 id="package.default.cache-lite.cache-lite-output.end.desc"> - &title.desc; - <para> - Stoppe la beufferisation de la sortie, démarrer par la méthode start() - et stocke la sortie dans un fichier de cache - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.end.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.caching.cache-lite.cache-lite-output.end.example"> - &title.example; - <example> - <title>Utilisation classique</title> - <programlisting role="php"> + <refnamediv> + <refname><function>Cache_Lite_Output::end</function></refname> + <refpurpose>Stoppe la beufferisation de la sortie, démarrer par la méthode start() + et stocke la sortie dans un fichier de cache</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + <funcsynopsisinfo> + require_once 'Cache/Lite/Output.php'; + </funcsynopsisinfo> + <funcprototype> + <funcdef>void <function>Cache_Lite_Output::end</function></funcdef> + <paramdef></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.default.cache-lite.cache-lite-output.end.desc"> + &title.desc; + <para> + Stoppe la beufferisation de la sortie, démarrée par la méthode start() + et stocke la sortie dans un fichier de cache. + </para> + </refsect1> + + <refsect1 id="package.default.cache-lite.cache-lite-output.end.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.caching.cache-lite.cache-lite-output.end.example"> + &title.example; + <example> + <title>Utilisation</title> + <programlisting role="php"> <![CDATA[ <?php require_once "Cache/Lite/Output.php"; @@ -57,10 +60,11 @@ ?> ]]> - </programlisting> - </example> - </refsect1> + </programlisting> + </example> + </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -79,4 +83,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml diff -u peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml:1.3 peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml:1.4 --- peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml:1.3 Sat Nov 6 14:49:00 2004 +++ peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml Sat Dec 17 17:25:32 2005 @@ -1,81 +1,93 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="package.default.cache-lite.cache-lite-output.start"> - <refnamediv> - <refname><function>Cache_Lite_Output::start</function></refname> - <refpurpose>Test si un cache est disponible et (si oui) le retourne au navigateur. - Sinon, la beufferisation de la sortie est activée.</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcsynopsisinfo> - require_once 'LiteOutput.php'; - </funcsynopsisinfo> - <funcprototype> - <funcdef>boolean <function>Cache_Lite_Output::start</function></funcdef> - <paramdef>string <parameter>$id</parameter></paramdef> - <paramdef>string <parameter> <optional>$group = 'default'</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - - <refsect1 id="package.default.cache-lite.cache-lite-output.start.desc"> - &title.desc; - <para> - Test si un cache est disponible et (si oui) le retourne au navigateur. - Sinon, la beufferisation de la sortie est activée. - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.start.param"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - - - &type.string; - <parameter>$id</parameter> - </term> - <listitem> - <para> - identifiant de cache - </para> - </listitem> - </varlistentry> - </variablelist> - <variablelist> - <varlistentry> - <term> - - - &type.string; - <parameter>$group</parameter> - </term> - <listitem> - <para> - nom du groupe de cache - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.start.returns"> - &title.returns; - <para> - retourne &true; si le cache est disponible (&false; sinon) - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.start.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.caching.cache-lite.cache-lite-output.start.example"> - &title.example; - <example> - <title>Utilisation classique</title> - <programlisting role="php"> + <refnamediv> + <refname><function>Cache_Lite_Output::start</function></refname> + <refpurpose>Test si un cache est disponible et (si oui) le retourne au navigateur. + Sinon, la beufferisation de la sortie est activée.</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + <funcsynopsisinfo> + require_once 'Cache/Lite/Output.php'; + </funcsynopsisinfo> + <funcprototype> + <funcdef>boolean <function>Cache_Lite_Output::start</function></funcdef> + <paramdef>string <parameter>$id</parameter></paramdef> + <paramdef>string <parameter> <optional>$group = 'default'</optional></parameter></paramdef> + <paramdef>boolean <parameter> <optional>$doNotTestCacheValidity = &false;</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.default.cache-lite.cache-lite-output.start.desc"> + &title.desc; + <para> + Test si un cache est disponible et (si oui) le retourne au navigateur. + Sinon, la beufferisation de la sortie est activée. + </para> + </refsect1> + + <refsect1 id="package.default.cache-lite.cache-lite-output.start.param"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$id</parameter> + </term> + <listitem> + <para> + identifiant de cache + </para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$group</parameter> + </term> + <listitem> + <para> + nom du groupe de cache + </para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + &type.bool; + <parameter>$doNotTestCacheValidity</parameter> + </term> + <listitem> + <para> + Si défini à &true;, la validité du cache ne sera pas testée + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.start.returns"> + &title.returns; + <para> + retourne &true; si le cache est disponible (&false; sinon) + </para> + </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.start.note"> + &title.note; + ¬e.notstatic; + </refsect1> + <refsect1 id="package.caching.cache-lite.cache-lite-output.start.example"> + &title.example; + <example> + <title>Utilisation</title> + <programlisting role="php"> <![CDATA[ <?php require_once "Cache/Lite/Output.php"; @@ -92,17 +104,18 @@ // Cache non présent ! // Toute la sortie est beufferisée en attendant la méthode end() // (...) - + $cache->end(); } ?> ]]> - </programlisting> - </example> - </refsect1> + </programlisting> + </example> + </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -121,4 +134,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/intro.xml?r1=1.4&r2=1.5&diff_format=u Index: peardoc/fr/package/caching/cache-lite/intro.xml diff -u peardoc/fr/package/caching/cache-lite/intro.xml:1.4 peardoc/fr/package/caching/cache-lite/intro.xml:1.5 --- peardoc/fr/package/caching/cache-lite/intro.xml:1.4 Sun Jun 12 20:12:39 2005 +++ peardoc/fr/package/caching/cache-lite/intro.xml Sat Dec 17 17:25:32 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <refentry id="package.caching.cache-lite.intro"> <refnamediv> @@ -15,8 +15,12 @@ les sites web à fort trafic, il est donc vraiment très rapide et sécurisé (car il utilise les verrous de fichiers et/ou des tests anti-corruptions). </para> + <para> + Note : une documentation indépendante de Cache_Lite est disponible en chinois + sur <ulink url="http://rainx.phpmore.com/manual/cache_lite.html">cette page</ulink>. + </para> </refsect1> - + <refsect1 id="package.caching.cache-lite.intro.technical"> <title>Buts et détails techniques</title> <refsect2 id="package.caching.cache-lite.intro.technical.speed"> @@ -28,7 +32,7 @@ </para> <para> Vous pouvez trouver plus de détails sur les choix techniques de ache_lite - sur <ulink url="http://www.pearfr.org/index.php/fr/article/cache_lite">ce document</ulink> + sur <ulink url="http://cvs.php.net/co.php/pear/Cache_Lite/docs/technical?r=1.1">ce document</ulink> mais l'idée principale est d'inclure le fichier PEAR.php uniquement lorsqu'une erreur survient (extrèmement rare). </para> @@ -38,28 +42,28 @@ <para> Parce que le système de cache est souvent inclus dans la couche applicative, le moteur PEAR::Cache_Lite doit être petit et flexible avec la licence LGPL. - Les fonctions avancées sont alors secondées dans des fichiers qui étendent - le moteur. + Les fonctions avancées peuvent être trouvées dans les fichiers qui étendent le moteur. </para> </refsect2> <refsect2> <title>Sécurité</title> <para> Sur les sites web à fort trafic, le système de cache doit être vraiment - protégé contre les corruptions de fichiers (à cause des accès concurents en mode lecture/écriture). - Vraiment très peu de systèmes de cache offrent une protection contre ce problème. + protégé contre les corruptions de fichiers (à cause des accès + concurents en mode lecture/écriture). Vraiment très peu de systèmes + de cache offrent une protection contre ce problème. </para> <para> Un verrou de fichier n'est pas une solution parfaite, car il est inutile avec NFS ou avec des serveurs multitâches. Donc, en plus des verrous de fichiers, PEAR::Cache_Lite offre deux mécanismes totalement transparents - (basés sur des clés de hashage) our garantir la sécurité des données en toutes - circonstances. Consultez le lien donné dans le paragraphe précédent pour - plus de détails. + (basés sur des clés de hashage) our garantir la sécurité des + données en toutes circonstances. Consultez le lien donné dans le paragraphe + précédent pour plus de détails. </para> </refsect2> </refsect1> - + <refsect1 id="package.caching.cache-lite.intro.usage"> <title>Utilisation</title> <refsect2 id="package.caching.cache-lite.intro.usage.general"> @@ -77,6 +81,7 @@ ces identifiants est laissé à la discrétion du développeur. </para> </refsect2> + <refsect2 id="package.caching.cache-lite.intro.usage.core"> <title>Partie principale</title> <para> @@ -117,7 +122,7 @@ } -?> +?> ]]> </programlisting> </para> @@ -158,6 +163,7 @@ </programlisting> </para> </refsect2> + <refsect2 id="package.caching.cache-lite.intro.usage.output"> <title>Partie principale</title> <para> @@ -223,12 +229,13 @@ </programlisting> </para> </refsect2> + <refsect2 id="package.caching.cache-lite.intro.usage.important"> - <title>Commentaire vraiment important</title> + <title>NOTE IMPORTANTE</title> <para> Pour une efficacité maximale avec Cache_Lite, n'incluez pas systématiquement - tout autre paquet dans votre page. Chargez les modules dont vous avez besoin - <emphasis>UNIQUEMENT</emphasis> lorsque la page n'est pas dans le cache + tout autre paquet nécessaire à votre page. Chargez <emphasis>UNIQUEMENT</emphasis> + les modules dont vous avez besoin lorsque la page n'est pas dans le cache (et doit donc être re-parsée) en utilisant une inclusion conditionnelle. </para> <para> @@ -253,7 +260,7 @@ </para> <para> Voici la meilleure façon (souvent, plus de deux fois plus rapide) : - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php require_once("Cache/Lite.php"); @@ -268,7 +275,7 @@ $Cache_Lite->save($data); } ?> -]]> +]]> </programlisting> </para> </refsect2> @@ -300,4 +307,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite.xml?r1=1.4&r2=1.5&diff_format=u Index: peardoc/fr/package/caching/cache-lite.xml diff -u peardoc/fr/package/caching/cache-lite.xml:1.4 peardoc/fr/package/caching/cache-lite.xml:1.5 --- peardoc/fr/package/caching/cache-lite.xml:1.4 Tue Jun 28 21:20:36 2005 +++ peardoc/fr/package/caching/cache-lite.xml Sat Dec 17 17:25:32 2005 @@ -1,19 +1,18 @@ -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: moosh Status: ready --> -<!-- Credit: yannick --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> + <sect1 id="package.caching.cache-lite"> <title>Cache_Lite</title> <para> - Cache_Lite fournit un système de cache rapide, + Cache_Lite fournit un système de cache rapide, léger et sécurisé. - Il est optimisé pour les conteneurs de fichiers et protège contre les corruptions dû au cache (car il utilise les verrous de fichiers et/ou des tests de hash). </para> - + &package.caching.cache-lite.intro; &package.caching.cache-lite.cache-lite.cache-lite; @@ -27,17 +26,19 @@ &package.caching.cache-lite.cache-lite.getmemorycachingstate; &package.caching.cache-lite.cache-lite.lastmodified; &package.caching.cache-lite.cache-lite.raiseerror; - + &package.caching.cache-lite.cache-lite-output.cache-lite-output; &package.caching.cache-lite.cache-lite-output.start; &package.caching.cache-lite.cache-lite-output.end; - + &package.caching.cache-lite.cache-lite-function.cache-lite-function; &package.caching.cache-lite.cache-lite-function.call; - + &package.caching.cache-lite.cache-lite-function.drop; + &package.caching.cache-lite.cache-lite-file.cache-lite-file; &package.caching.cache-lite.cache-lite-file.get; </sect1> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -56,4 +57,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml diff -u peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml:1.3 peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml:1.4 --- peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml:1.3 Fri Jun 24 15:10:26 2005 +++ peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml Sat Dec 17 17:25:32 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> + <refentry id="package.database.db-dataobject.intro-autobuilding"> <refnamediv> <refname>Construction automatique et schéma de base de données</refname> @@ -54,6 +55,11 @@ Celà lira votre fichier de configuration et génèrera tous les classes de base ainsi que les fichiers de définitions de données. </para> + <para> + Depuis la version 1.5, vous pouvez utiliser l'option "proxy = full", ce qui fera + que DataObjects créera des classes et des schémas à la volée, plutôt que d'utiliser + un fichier ini ou des classes de pré-construction. + </para> </refsect1> <refsect1> <title>définition de la classe par défaut</title> @@ -94,7 +100,6 @@ ###END_AUTOCODE } - ]]> </programlisting> </example> @@ -142,26 +147,25 @@ changements risqueraient d'être perdus lors de la regénération). Vous pouvez effacer les clés d'une table en utilisant l'option de configuration "sequence_{table} = key" ou - en définissant la méthode sequenceKey() de votre classe étendue. + en définissant la méthode sequenceKey() de votre classe étendue. <example> <title>Fichier de configuration de base de données</title> - <programlisting role="ini"><![CDATA[ - + <programlisting role="ini"> +<![CDATA[ [group] id = 129 -name = 130 -grp_owner = 129 -official = 130 -street = 130 +name = 130 +grp_owner = 129 +official = 130 +street = 130 postcode = 130 -city = 130 -homepage = 130 -email = 130 -extra = 130 +city = 130 +homepage = 130 +email = 130 +extra = 130 [group__keys] -id = N - +id = N ]]> </programlisting> </example> @@ -174,12 +178,12 @@ </para> </refsect1> - + <refsect1> <title>Alternatives à l'utilisation d'un fichier de schéma</title> <para> Il est possible d'utiliser DataObjects sans fichier de schéma ; cela, - de deux façons : + de deux façons : <itemizedlist> <listitem> <simpara> @@ -196,12 +200,11 @@ </itemizedlist> La seconde méthode est détaillé dans la page des méthodes keys() and tables(). - </para> + </para> <para> Ci-dessous, une classe écrite manuellement qui n'utilise pas un fichier de schéma schema.ini. </para> - <para> Elle est prévue pour retourner une valeur depuis une méthode, plutôt qu'une variable objet, donc, l'affichage de print_r(), @@ -231,14 +234,12 @@ var $homepage; // string var $email; // string var $extra; // blob - - + // these are usefull to be consistant with a autogenerated file. - + /* Static get */ function staticGet($k,$v=NULL) { return DB_DataObject::staticGet('DataObjects_Grp',$k,$v); } - // now define your table structure. // key is column name, value is type function table() { @@ -252,17 +253,13 @@ 'photo' => DB_DATAOBJECT_STR + DB_DATAOBJECT_BLOB, ); } - + // now define the keys. function keys() { return array('id'); } - - - -} - +} ]]> </programlisting> </example> @@ -288,4 +285,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db-dataobject/intro-configuration.xml?r1=1.2&r2=1.3&diff_format=u Index: peardoc/fr/package/database/db-dataobject/intro-configuration.xml diff -u peardoc/fr/package/database/db-dataobject/intro-configuration.xml:1.2 peardoc/fr/package/database/db-dataobject/intro-configuration.xml:1.3 --- peardoc/fr/package/database/db-dataobject/intro-configuration.xml:1.2 Sun Nov 7 19:42:13 2004 +++ peardoc/fr/package/database/db-dataobject/intro-configuration.xml Sat Dec 17 17:25:32 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> + <refentry id="package.database.db-dataobject.intro-configuration"> <refnamediv> <refname>Options de configuration</refname> @@ -8,7 +9,7 @@ Définition des options par défaut d'accès à une base de données </refpurpose> </refnamediv> - + <refsect1> <title>Configuration</title> <para> @@ -63,16 +64,10 @@ </example> </refsect1> - -<!-- -Config Options ---> - - <refsect1> <title>Options de configuration - Requis</title> <variablelist> - + <varlistentry> <term> <parameter>database</parameter> @@ -84,7 +79,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>schema_location</parameter> @@ -105,7 +100,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>require_prefix</parameter> @@ -139,20 +134,15 @@ </para> </listitem> </varlistentry> - + </variablelist> </refsect1> -<!-- -Config Options - Optional ---> - - <refsect1> <title>Options de configuration - Optionnelles</title> <variablelist> - + <varlistentry> <term> <parameter>sequence_{table}</parameter> @@ -174,7 +164,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>ignore_sequence_keys</parameter> @@ -188,7 +178,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>debug</parameter> @@ -213,8 +203,7 @@ </para> </listitem> </varlistentry> - - + <varlistentry> <term> <parameter>dont_die</parameter> @@ -232,15 +221,48 @@ </para> </listitem> </varlistentry> - - </variablelist> - - </refsect1> + <varlistentry> + <term> + <parameter>quote_identifiers</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Pour forcer l'ajout de quote aux identifiants dans les requêtes SQL, définissez + à 1 + <example> + <title>Requête générée avec et sans quote_identifiers</title> + <programlisting role="ini"> +<![CDATA[ +quote_identifiers = 1; +SELECT 'somecol' FROM 'sometable' WHERE 'somevalue'=1; -<!-- -Config Options - Multi Database ---> +quote_identifiers = 0; +SELECT somecol FROM sometable WHERE somevalue=1; + +]]> + </programlisting> + </example> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>proxy</parameter> + <type>string</type> + </term> + <listitem> + <para> + Ceci active la construction des classe et des classes ini à la volée, plutôt + que ce soit vous qui écriviez le code. (actuellement, la seule valeur supportée est + "full", qui génère le schéma des données et la classe par défaut) + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> <refsect1> <title>Opitons de configuration - Bases de données multiples (optionnel)</title> @@ -268,7 +290,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>table_*</parameter> @@ -291,22 +313,14 @@ </para> </listitem> </varlistentry> - </variablelist> - </refsect1> -<!-- - - Config Options - BUILDER - ---> - <refsect1> <title>Options de configuration - Construction</title> - + <variablelist> - + <varlistentry> <term> <parameter>class_location</parameter> @@ -340,7 +354,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>extends_location</parameter> @@ -358,11 +372,11 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>generator_class_rewrite</parameter> - <type>dossier</type> + <type>boolean</type> </term> <listitem> <para> @@ -373,9 +387,6 @@ </listitem> </varlistentry> - - - <varlistentry> <term> <parameter>build_views</parameter> @@ -385,21 +396,75 @@ <para> Postgres (et surement d'autres) vous permet de traiter les vues comme des tables normales (i.e. insert/update/delete etc. fonctionne sur ces tables), - vous pouvez utilisez cette option pour générer - les fichiers pour toutes les vues de la base de données. + vous pouvez utilisez cette option pour générer + les fichiers pour toutes les vues de la base de données. </para> <para> - Note : Vous devez spécifier les clés manuellement dans les classes générées (i.e. - définission des méthodes keys() et sequenceKey() ), car le générateur - ne peut pas deviner quelles sont les clés préférées. - </para> + Note : Vous devez spécifier les clés manuellement dans les classes générées (i.e. + définission des méthodes keys() et sequenceKey() ), car le générateur + ne peut pas deviner quelles sont les clés préférées. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_include_regex</parameter> + <type>string</type> + </term> + <listitem> + <para> + Si vous ne voulez générer que les classes et les entrées ini pour des tables spécifiques, + vous pouvez utiliser ce aramètre pour construire un masque, seules les tables avec des noms + correspondant à ce masque seront générées, par exemple /mytables_.*/ + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_exclude_regex</parameter> + <type>string</type> + </term> + <listitem> + <para> + Si vous voulez explicitement prévenir la génération des classes et des entrées ini pour des tables + spécifiques, vous pouvez utiliser ce paramètre pour construire un masque, toutes les tables + qui correspondent à ce masque ne seront pas générées, par exemple /private_tables_.*/ + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_novars</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Si &true;, le générateur n'écrira pas de définition privé ou de variable + pour les colonnes, donc, vous pouvez surcharger get/set. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_add_validate_stubs</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Si &true; le générateur insérera un / (ou l'ajoute aux fichiers existants) + pour les méthodes valides. + </para> </listitem> </varlistentry> - + </variablelist> - </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -418,4 +483,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db/db/iserror.xml?r1=1.5&r2=1.6&diff_format=u Index: peardoc/fr/package/database/db/db/iserror.xml diff -u peardoc/fr/package/database/db/db/iserror.xml:1.5 peardoc/fr/package/database/db/db/iserror.xml:1.6 --- peardoc/fr/package/database/db/db/iserror.xml:1.5 Wed Jul 7 21:22:04 2004 +++ peardoc/fr/package/database/db/db/iserror.xml Sat Dec 17 17:25:32 2005 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.15 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> <refentry id="package.database.db.db.iserror"> <refnamediv> <refname>DB::isError()</refname> <refpurpose>Détermine si une variable est un objet DB_Error</refpurpose> </refnamediv> - + <refsynopsisdiv> <funcsynopsis> <funcprototype> @@ -18,15 +18,20 @@ </funcprototype> </funcsynopsis> </refsynopsisdiv> - + <refsect1 id="package.database.db.db.iserror.desc"> &title.desc; <para> Vérifie si le code de retour d'une méthode de DB est un objet &class.db-error; ou non. </para> + <para> + Il est préférable d'utiliser + <function>PEAR::isError</function> + au lieu de la fonction <function>isError</function> spécifique à DB. + </para> </refsect1> - + <refsect1 id="package.database.db.db.iserror.parameter"> &title.param; <para> @@ -45,6 +50,7 @@ </variablelist> </para> </refsect1> + <refsect1 id="package.database.db.db.iserror.return"> &title.returns; <para> @@ -52,7 +58,7 @@ est un objet &class.db-error; </para> </refsect1> - + <refsect1 id="package.database.db.db.iserror.note"> &title.note; ¬e.shouldstatic; @@ -68,7 +74,7 @@ require_once 'DB.php'; $db =& DB::connect('pgsql://usr:pw@localhost/dbnam'); -if (DB::isError($db)) { +if (PEAR::isError($db)) { die($db->getMessage()); } ?> @@ -96,4 +102,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db/db-result/fetchinto.xml?r1=1.2&r2=1.3&diff_format=u Index: peardoc/fr/package/database/db/db-result/fetchinto.xml diff -u peardoc/fr/package/database/db/db-result/fetchinto.xml:1.2 peardoc/fr/package/database/db/db-result/fetchinto.xml:1.3 --- peardoc/fr/package/database/db/db-result/fetchinto.xml:1.2 Wed Jul 7 21:22:04 2004 +++ peardoc/fr/package/database/db/db-result/fetchinto.xml Sat Dec 17 17:25:32 2005 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.27 Maintainer: didou Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.28 Maintainer: didou Status: ready --> <refentry id="package.database.db.db-result.fetchinto"> <refnamediv> <refname>DB_result::fetchInto()</refname> <refpurpose>Récupère une ligne dans une variable</refpurpose> </refnamediv> - + <refsynopsisdiv> <funcsynopsis> <funcprototype> @@ -25,7 +25,7 @@ </funcprototype> </funcsynopsis> </refsynopsisdiv> - + <refsect1 id="package.database.db.db-result.fetchinto.desc"> &title.desc; <para> @@ -34,7 +34,7 @@ Les données peuvent être formatées en tableau ou en objet. </para> </refsect1> - + <refsect1 id="package.database.db.db-result.fetchinto.parameter"> &title.param; <para> @@ -91,14 +91,15 @@ </term> <listitem> <para> - le numéro de la ligne à récupérer + le numéro de la ligne à récupérer. + Notez que 0 retourne la première ligne, 1 retourne la seconde, etc. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> - + <refsect1 id="package.database.db.db-result.fetchinto.return"> &title.returns; <para> @@ -107,7 +108,7 @@ un objet &class.db-error; en cas d'erreur </para> </refsect1> - + <refsect1 id="package.database.db.db-result.fetchinto.note"> &title.note; ¬e.notstatic; @@ -164,4 +165,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db/db-result/numrows.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/database/db/db-result/numrows.xml diff -u peardoc/fr/package/database/db/db-result/numrows.xml:1.3 peardoc/fr/package/database/db/db-result/numrows.xml:1.4 --- peardoc/fr/package/database/db/db-result/numrows.xml:1.3 Sun Nov 7 19:42:13 2004 +++ peardoc/fr/package/database/db/db-result/numrows.xml Sat Dec 17 17:25:32 2005 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.21 Maintainer: didou Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> <refentry id="package.database.db.db-result.numrows"> <refnamediv> <refname>DB_result::numRows()</refname> <refpurpose>Retourne le nombre de lignes</refpurpose> </refnamediv> - + <refsynopsisdiv> <funcsynopsis> <funcprototype> @@ -16,14 +16,29 @@ </funcprototype> </funcsynopsis> </refsynopsisdiv> - + <refsect1 id="package.database.db.db-result.numrows.desc"> &title.desc; <para> Retourne le nombre de lignes dans le résultat. </para> + <warning> + <para> + Pour <literal>ibase</literal>, <literal>ifx</literal> et + <literal>oci8</literal>, cette méthode ne fonctionne que si + l'<link linkend="package.database.db.intro-portability">option + de portabilité</link> + <constant>DB_PORTABILITY_NUMROWS</constant> + est activée. De plus, pour <literal>ibase</literal> et + <literal>ifx</literal>, PEAR DB doit être à la version + 1.7.0 ou supérieure. + </para> + <para> + Ne fonctionne pas avec Microsoft Access. + </para> + </warning> </refsect1> - + <refsect1 id="package.database.db.db-result.numrows.return"> &title.returns; <para> @@ -31,7 +46,52 @@ ou un objet &class.db-error; en cas d'erreur </para> </refsect1> - + + <refsect1 id="package.database.db.db-result.numrows.return"> + &title.returns; + <para> + &type.int; - number of rows + or a &class.db-error; object on failure + </para> + </refsect1> + + <refsect1 id="package.database.db.db-result.numrows.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message d'erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_NOT_CAPABLE</constant></entry> + <entry> + DB backend not capable + </entry> + <entry> + Le driver ne supporte pas cette fonctionalité. + </entry> + <entry> + Soit vous prenez un autre système de base de données ou + vous activez + l'<link linkend="package.database.db.intro-portability">option + de portabilité</link> + <constant>DB_PORTABILITY_NUMROWS</constant>. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1 id="package.database.db.db-result.numrows.note"> &title.note; ¬e.notstatic; @@ -52,7 +112,7 @@ </programlisting> </example> </refsect1> - + <refsect1 id="package.database.db.db-result.numrows.see"> &title.see; <para> @@ -82,4 +142,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml diff -u peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml:1.3 peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml:1.4 --- peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml:1.3 Sun Jun 12 19:56:36 2005 +++ peardoc/fr/package/caching/cache-lite/cache-lite-output/cache_lite_output.xml Sat Dec 17 17:25:32 2005 @@ -1,274 +1,315 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="package.default.cache-lite.cache-lite-output.cache-lite-output"> - <refnamediv> - <refname>constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></refname> - <refpurpose>Constructeur</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcsynopsisinfo> - require_once 'LiteOutput.php'; - </funcsynopsisinfo> - <funcprototype> - <funcdef>void constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></funcdef> - <paramdef>array <parameter>$options</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> + <refnamediv> + <refname>constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></refname> + <refpurpose>Constructeur</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + <funcsynopsisinfo> + require_once 'Cache/Lite/Output.php'; + </funcsynopsisinfo> + <funcprototype> + <funcdef>void constructor <function>Cache_Lite_Output::Cache_Lite_Output</function></funcdef> + <paramdef>array <parameter>$options</parameter></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.desc"> + &title.desc; + <para> + Le constructeur de la classe Cache_Lite_Output. Vous pouvez passer un tableau associatif + comme argument pour définir beaucoup d'options. + </para> + </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.desc"> - &title.desc; - <para> - Le constructeur de la classe Cache_Lite_Output. Vous pouvez passer un tableau associatif - comme argument pour définir beaucoup d'options. - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.param"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - - - &type.array; - <parameter>$options</parameter> - </term> - <listitem> - <para> - tableau associatif pour définir beaucoup d'options - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - <table> - <title></title> - <tgroup cols="4"> - <thead> - <row> - <entry>Options</entry> - <entry>Type de données</entry> - <entry>Valeur par défaut</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry> - cacheDir - </entry> - <entry> - &type.string; - </entry> - <entry> - /tmp/ - </entry> - <entry> - dossier où seront stockés les fichier de cache (avec un slash final) - </entry> - </row> - <row> - <entry> - caching - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive le cache - </entry> - </row> - <row> - <entry> - lifeTime - </entry> - <entry> - &type.int; - </entry> - <entry> - 3600 - </entry> - <entry> - durée de vie du cache en seconde - </entry> - </row> - <row> - <entry> - fileLocking - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive les verrous de fichiers (peut - éviter des corruptions de cache dans de mauvaises circonstances) - </entry> - </row> - <row> - <entry> - writeControl - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive le contrôle d'écriture (l'activation du contrôle d'écriture - ralentie un peu l'écriture du cache mais l'inflût pas sur la lecture ; - le contrôle d'écriture peut détecter quelques fichiers de cache - corrumpus mais cependant, ce n'est pas un contrôle parfait) - </entry> - </row> - <row> - <entry> - readControl - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - active / désactive le contrôle de lecture (si activé, une clé de contrôle est - incluse dans le fichier de cache et cette clé est comparé avec celle calculé - après la lecture) - </entry> - </row> - <row> - <entry> - readControlType - </entry> - <entry> - &type.string; - </entry> - <entry> - crc32 - </entry> - <entry> - Type de contrôle de lecture (uniquement si le contrôle de lecture est activé). - Doit être 'MD5' (pour un contrôle de hash MD5 (le meilleur mais lent)), - 'crc32' (pour un contrôle de hash crc32 (un peu moins sécurisé mais rapide)) ou - 'srtlen' (pour un test de longueur uniquement (très rapide)). - </entry> - </row> - <row> - <entry> - pearErrorMode - </entry> - <entry> - &type.int; - </entry> - <entry> - CACHE_LITE_ERROR_RETURN - </entry> - <entry> - mode d'erreur PEAR (lorsque raiseError est appelé ) (CACHE_LITE_ERROR_RETURN - pour uniquement retourner un objet PEAR_Error ou CACHE_LITE_ERROR_DIE - pour stopper immédiatement le script (idéal pour le débogage)). - </entry> - </row> - <row> - <entry> - fileNameProtection - </entry> - <entry> - &type.bool; - </entry> - <entry> - &true; - </entry> - <entry> - Protection du nom de fichier (si définie à TRUE, vous pouvez utiliser - n'importe quelle identifiant ou nom de groupe, si définie à FALSE, la - rapidité est accrue mais les identifiants de cache et les noms de groupe - seront utilisés directement dans le nom du fichier de cache donc, - attention avecles caractères spéciaux...) - </entry> - </row> - <row> - <entry> - automaticSerialization - </entry> - <entry> - &type.bool; - </entry> - <entry> - &false; - </entry> - <entry> - active / désactive la linéarisation automatique (peut être utilisé pour sauvegarder - directement les données qui ne sont pas des chaînes de caractères mais celà - ralentie le processus) - </entry> - </row> - <row> - <entry> - memoryCaching - </entry> - <entry> - &type.bool; - </entry> - <entry> - &false; - </entry> - <entry> - [BETA QUALITY] active / désactive "Cache en mémoire" - (NB : il n'y pas de durée de vie pour le cache en mémoire, uniquement en fin de script) - </entry> - </row> - <row> - <entry> - onlyMemoryCaching - </entry> - <entry> - &type.bool; - </entry> - <entry> - &false; - </entry> - <entry> - [BETA QUALITY] active / désactive "Cache en mémoire uniquement" - (si activé, les fichiers ne sont pas du tout utilisés) - </entry> - </row> - <row> - <entry> - memoryCachingLimit - </entry> - <entry> - &type.int; - </entry> - <entry> - 1000 - </entry> - <entry> - [BETA QUALITY] le nombre maximal d'enregistrements pouvant - être stockés en cache mémoire. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.param"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.array; + <parameter>$options</parameter> + </term> + <listitem> + <para> + tableau associatif pour définir beaucoup d'options + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + <table> + <title></title> + <tgroup cols="4"> + <thead> + <row> + <entry>Options</entry> + <entry>Type de données</entry> + <entry>Valeur par défaut</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + cacheDir + </entry> + <entry> + &type.string; + </entry> + <entry> + /tmp/ + </entry> + <entry> + dossier où seront stockés les fichier de cache (avec un slash final) + </entry> + </row> + <row> + <entry> + caching + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive le cache + </entry> + </row> + <row> + <entry> + lifeTime + </entry> + <entry> + &type.int; + </entry> + <entry> + 3600 + </entry> + <entry> + durée de vie du cache en seconde (depuis 1.6.0beta1, vous pouvez utiliser une valeur nulle pour + obtenir un cache éternel) + </entry> + </row> + <row> + <entry> + fileLocking + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive les verrous de fichiers (peut + éviter des corruptions de cache dans de mauvaises circonstances) + </entry> + </row> + <row> + <entry> + writeControl + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive le contrôle d'écriture (l'activation du contrôle d'écriture + ralentie un peu l'écriture du cache mais l'inflût pas sur la lecture ; + le contrôle d'écriture peut détecter quelques fichiers de cache + corrumpus mais cependant, ce n'est pas un contrôle parfait) + </entry> + </row> + <row> + <entry> + readControl + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + active / désactive le contrôle de lecture (si activé, une clé de contrôle est + incluse dans le fichier de cache et cette clé est comparé avec celle calculé + après la lecture) + </entry> + </row> + <row> + <entry> + readControlType + </entry> + <entry> + &type.string; + </entry> + <entry> + crc32 + </entry> + <entry> + Type de contrôle de lecture (uniquement si le contrôle de lecture est activé). + Doit être 'MD5' (pour un contrôle de hash MD5 (le meilleur mais lent)), + 'crc32' (pour un contrôle de hash crc32 (un peu moins sécurisé mais rapide)) ou + 'srtlen' (pour un test de longueur uniquement (très rapide)). + </entry> + </row> + <row> + <entry> + pearErrorMode + </entry> + <entry> + &type.int; + </entry> + <entry> + CACHE_LITE_ERROR_RETURN + </entry> + <entry> + mode d'erreur PEAR (lorsque raiseError est appelé ) (CACHE_LITE_ERROR_RETURN + pour uniquement retourner un objet PEAR_Error ou CACHE_LITE_ERROR_DIE + pour stopper immédiatement le script (idéal pour le débogage)). + </entry> + </row> + <row> + <entry> + fileNameProtection + </entry> + <entry> + &type.bool; + </entry> + <entry> + &true; + </entry> + <entry> + Protection du nom de fichier (si définie à TRUE, vous pouvez utiliser + n'importe quelle identifiant ou nom de groupe, si définie à FALSE, la + rapidité est accrue mais les identifiants de cache et les noms de groupe + seront utilisés directement dans le nom du fichier de cache donc, + attention avecles caractères spéciaux...) + </entry> + </row> + <row> + <entry> + automaticSerialization + </entry> + <entry> + &type.bool; + </entry> + <entry> + &false; + </entry> + <entry> + active / désactive la linéarisation automatique (peut être utilisé pour sauvegarder + directement les données qui ne sont pas des chaînes de caractères mais celà + ralentie le processus) + </entry> + </row> + <row> + <entry> + memoryCaching + </entry> + <entry> + &type.bool; + </entry> + <entry> + &false; + </entry> + <entry> + active / désactive "Cache en mémoire" + (NB : il n'y pas de durée de vie pour le cache en mémoire, uniquement en fin de script) + </entry> + </row> + <row> + <entry> + onlyMemoryCaching + </entry> + <entry> + &type.bool; + </entry> + <entry> + &false; + </entry> + <entry> + active / désactive "Cache en mémoire uniquement" + (si activé, les fichiers ne sont pas du tout utilisés) + </entry> + </row> + <row> + <entry> + memoryCachingLimit + </entry> + <entry> + &type.int; + </entry> + <entry> + 1000 + </entry> + <entry> + le nombre maximal d'enregistrements pouvant + être stockés en cache mémoire. + </entry> + </row> + <row> + <entry> + automaticCleaningFactor + </entry> + <entry> + &type.int; + </entry> + <entry> + 0 + </entry> + <entry> + Désactive / personnalise le processus de nettoyage automatique. + Le processus de nettoyage automatique détruit les fichiers de cache + trop anciens (pour une durée de cache donnée) lorsqu'un nouveau + fichier de cache est écrit. 0 signifie "aucun nettoyage de cache automatique", + 1 signifie "nettoyage du cache systèmatique" (lent), x>1 signifie + "nettoyage automatique 1 fois tous les x fichiers de cache écrits". Une valeur + entre 20 et 200 est surement un bon début. + </entry> + </row> + <row> + <entry> + hashedDirectoryLevel + </entry> + <entry> + &type.int; + </entry> + <entry> + 0 + </entry> + <entry> + Définit le degré de structure du dossiers de hashage. 0 signifie + "aucune structure de dossiers de hashage", 1 signifie "un degré de dossier", + 2 signifie "deux degrés"...Cette option peut améliorer la vitesse de Cache_Lite + uniquement lorsque vous avez plusieurs centaines de fichiers de cache. + La seule solution pour connaître la bonne valeur pour votre cas est de faire + des tests en situation réelle. Peut-être qu'1 ou 2 est un bon début. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.note"> - &title.note; - ¬e.notstatic; - </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.cache-lite-output.note"> + &title.note; + ¬e.notstatic; + </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -287,4 +328,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml?r1=1.2&r2=1.3&diff_format=u Index: peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml diff -u peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml:1.2 peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml:1.3 --- peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml:1.2 Sun Jul 25 15:13:42 2004 +++ peardoc/fr/package/caching/cache-lite/cache-lite-output/end.xml Sat Dec 17 17:25:32 2005 @@ -1,39 +1,42 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="package.default.cache-lite.cache-lite-output.end"> - <refnamediv> - <refname><function>Cache_Lite_Output::end</function></refname> - <refpurpose>Stoppe la beufferisation de la sortie, démarrer par la méthode start() - et stocke la sortie dans un fichier de cache</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcsynopsisinfo> - require_once 'LiteOutput.php'; - </funcsynopsisinfo> - <funcprototype> - <funcdef>void <function>Cache_Lite_Output::end</function></funcdef> -<paramdef></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - - <refsect1 id="package.default.cache-lite.cache-lite-output.end.desc"> - &title.desc; - <para> - Stoppe la beufferisation de la sortie, démarrer par la méthode start() - et stocke la sortie dans un fichier de cache - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.end.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.caching.cache-lite.cache-lite-output.end.example"> - &title.example; - <example> - <title>Utilisation classique</title> - <programlisting role="php"> + <refnamediv> + <refname><function>Cache_Lite_Output::end</function></refname> + <refpurpose>Stoppe la beufferisation de la sortie, démarrer par la méthode start() + et stocke la sortie dans un fichier de cache</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + <funcsynopsisinfo> + require_once 'Cache/Lite/Output.php'; + </funcsynopsisinfo> + <funcprototype> + <funcdef>void <function>Cache_Lite_Output::end</function></funcdef> + <paramdef></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.default.cache-lite.cache-lite-output.end.desc"> + &title.desc; + <para> + Stoppe la beufferisation de la sortie, démarrée par la méthode start() + et stocke la sortie dans un fichier de cache. + </para> + </refsect1> + + <refsect1 id="package.default.cache-lite.cache-lite-output.end.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.caching.cache-lite.cache-lite-output.end.example"> + &title.example; + <example> + <title>Utilisation</title> + <programlisting role="php"> <![CDATA[ <?php require_once "Cache/Lite/Output.php"; @@ -57,10 +60,11 @@ ?> ]]> - </programlisting> - </example> - </refsect1> + </programlisting> + </example> + </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -79,4 +83,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml diff -u peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml:1.3 peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml:1.4 --- peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml:1.3 Sat Nov 6 14:49:00 2004 +++ peardoc/fr/package/caching/cache-lite/cache-lite-output/start.xml Sat Dec 17 17:25:32 2005 @@ -1,81 +1,93 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="package.default.cache-lite.cache-lite-output.start"> - <refnamediv> - <refname><function>Cache_Lite_Output::start</function></refname> - <refpurpose>Test si un cache est disponible et (si oui) le retourne au navigateur. - Sinon, la beufferisation de la sortie est activée.</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcsynopsisinfo> - require_once 'LiteOutput.php'; - </funcsynopsisinfo> - <funcprototype> - <funcdef>boolean <function>Cache_Lite_Output::start</function></funcdef> - <paramdef>string <parameter>$id</parameter></paramdef> - <paramdef>string <parameter> <optional>$group = 'default'</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - - <refsect1 id="package.default.cache-lite.cache-lite-output.start.desc"> - &title.desc; - <para> - Test si un cache est disponible et (si oui) le retourne au navigateur. - Sinon, la beufferisation de la sortie est activée. - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.start.param"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - - - &type.string; - <parameter>$id</parameter> - </term> - <listitem> - <para> - identifiant de cache - </para> - </listitem> - </varlistentry> - </variablelist> - <variablelist> - <varlistentry> - <term> - - - &type.string; - <parameter>$group</parameter> - </term> - <listitem> - <para> - nom du groupe de cache - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.start.returns"> - &title.returns; - <para> - retourne &true; si le cache est disponible (&false; sinon) - </para> - </refsect1> - <refsect1 id="package.default.cache-lite.cache-lite-output.start.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.caching.cache-lite.cache-lite-output.start.example"> - &title.example; - <example> - <title>Utilisation classique</title> - <programlisting role="php"> + <refnamediv> + <refname><function>Cache_Lite_Output::start</function></refname> + <refpurpose>Test si un cache est disponible et (si oui) le retourne au navigateur. + Sinon, la beufferisation de la sortie est activée.</refpurpose> + </refnamediv> + <refsynopsisdiv> + <funcsynopsis> + <funcsynopsisinfo> + require_once 'Cache/Lite/Output.php'; + </funcsynopsisinfo> + <funcprototype> + <funcdef>boolean <function>Cache_Lite_Output::start</function></funcdef> + <paramdef>string <parameter>$id</parameter></paramdef> + <paramdef>string <parameter> <optional>$group = 'default'</optional></parameter></paramdef> + <paramdef>boolean <parameter> <optional>$doNotTestCacheValidity = &false;</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.default.cache-lite.cache-lite-output.start.desc"> + &title.desc; + <para> + Test si un cache est disponible et (si oui) le retourne au navigateur. + Sinon, la beufferisation de la sortie est activée. + </para> + </refsect1> + + <refsect1 id="package.default.cache-lite.cache-lite-output.start.param"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$id</parameter> + </term> + <listitem> + <para> + identifiant de cache + </para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$group</parameter> + </term> + <listitem> + <para> + nom du groupe de cache + </para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + &type.bool; + <parameter>$doNotTestCacheValidity</parameter> + </term> + <listitem> + <para> + Si défini à &true;, la validité du cache ne sera pas testée + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.start.returns"> + &title.returns; + <para> + retourne &true; si le cache est disponible (&false; sinon) + </para> + </refsect1> + <refsect1 id="package.default.cache-lite.cache-lite-output.start.note"> + &title.note; + ¬e.notstatic; + </refsect1> + <refsect1 id="package.caching.cache-lite.cache-lite-output.start.example"> + &title.example; + <example> + <title>Utilisation</title> + <programlisting role="php"> <![CDATA[ <?php require_once "Cache/Lite/Output.php"; @@ -92,17 +104,18 @@ // Cache non présent ! // Toute la sortie est beufferisée en attendant la méthode end() // (...) - + $cache->end(); } ?> ]]> - </programlisting> - </example> - </refsect1> + </programlisting> + </example> + </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -121,4 +134,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite/intro.xml?r1=1.4&r2=1.5&diff_format=u Index: peardoc/fr/package/caching/cache-lite/intro.xml diff -u peardoc/fr/package/caching/cache-lite/intro.xml:1.4 peardoc/fr/package/caching/cache-lite/intro.xml:1.5 --- peardoc/fr/package/caching/cache-lite/intro.xml:1.4 Sun Jun 12 20:12:39 2005 +++ peardoc/fr/package/caching/cache-lite/intro.xml Sat Dec 17 17:25:32 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <refentry id="package.caching.cache-lite.intro"> <refnamediv> @@ -15,8 +15,12 @@ les sites web à fort trafic, il est donc vraiment très rapide et sécurisé (car il utilise les verrous de fichiers et/ou des tests anti-corruptions). </para> + <para> + Note : une documentation indépendante de Cache_Lite est disponible en chinois + sur <ulink url="http://rainx.phpmore.com/manual/cache_lite.html">cette page</ulink>. + </para> </refsect1> - + <refsect1 id="package.caching.cache-lite.intro.technical"> <title>Buts et détails techniques</title> <refsect2 id="package.caching.cache-lite.intro.technical.speed"> @@ -28,7 +32,7 @@ </para> <para> Vous pouvez trouver plus de détails sur les choix techniques de ache_lite - sur <ulink url="http://www.pearfr.org/index.php/fr/article/cache_lite">ce document</ulink> + sur <ulink url="http://cvs.php.net/co.php/pear/Cache_Lite/docs/technical?r=1.1">ce document</ulink> mais l'idée principale est d'inclure le fichier PEAR.php uniquement lorsqu'une erreur survient (extrèmement rare). </para> @@ -38,28 +42,28 @@ <para> Parce que le système de cache est souvent inclus dans la couche applicative, le moteur PEAR::Cache_Lite doit être petit et flexible avec la licence LGPL. - Les fonctions avancées sont alors secondées dans des fichiers qui étendent - le moteur. + Les fonctions avancées peuvent être trouvées dans les fichiers qui étendent le moteur. </para> </refsect2> <refsect2> <title>Sécurité</title> <para> Sur les sites web à fort trafic, le système de cache doit être vraiment - protégé contre les corruptions de fichiers (à cause des accès concurents en mode lecture/écriture). - Vraiment très peu de systèmes de cache offrent une protection contre ce problème. + protégé contre les corruptions de fichiers (à cause des accès + concurents en mode lecture/écriture). Vraiment très peu de systèmes + de cache offrent une protection contre ce problème. </para> <para> Un verrou de fichier n'est pas une solution parfaite, car il est inutile avec NFS ou avec des serveurs multitâches. Donc, en plus des verrous de fichiers, PEAR::Cache_Lite offre deux mécanismes totalement transparents - (basés sur des clés de hashage) our garantir la sécurité des données en toutes - circonstances. Consultez le lien donné dans le paragraphe précédent pour - plus de détails. + (basés sur des clés de hashage) our garantir la sécurité des + données en toutes circonstances. Consultez le lien donné dans le paragraphe + précédent pour plus de détails. </para> </refsect2> </refsect1> - + <refsect1 id="package.caching.cache-lite.intro.usage"> <title>Utilisation</title> <refsect2 id="package.caching.cache-lite.intro.usage.general"> @@ -77,6 +81,7 @@ ces identifiants est laissé à la discrétion du développeur. </para> </refsect2> + <refsect2 id="package.caching.cache-lite.intro.usage.core"> <title>Partie principale</title> <para> @@ -117,7 +122,7 @@ } -?> +?> ]]> </programlisting> </para> @@ -158,6 +163,7 @@ </programlisting> </para> </refsect2> + <refsect2 id="package.caching.cache-lite.intro.usage.output"> <title>Partie principale</title> <para> @@ -223,12 +229,13 @@ </programlisting> </para> </refsect2> + <refsect2 id="package.caching.cache-lite.intro.usage.important"> - <title>Commentaire vraiment important</title> + <title>NOTE IMPORTANTE</title> <para> Pour une efficacité maximale avec Cache_Lite, n'incluez pas systématiquement - tout autre paquet dans votre page. Chargez les modules dont vous avez besoin - <emphasis>UNIQUEMENT</emphasis> lorsque la page n'est pas dans le cache + tout autre paquet nécessaire à votre page. Chargez <emphasis>UNIQUEMENT</emphasis> + les modules dont vous avez besoin lorsque la page n'est pas dans le cache (et doit donc être re-parsée) en utilisant une inclusion conditionnelle. </para> <para> @@ -253,7 +260,7 @@ </para> <para> Voici la meilleure façon (souvent, plus de deux fois plus rapide) : - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php require_once("Cache/Lite.php"); @@ -268,7 +275,7 @@ $Cache_Lite->save($data); } ?> -]]> +]]> </programlisting> </para> </refsect2> @@ -300,4 +307,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/caching/cache-lite.xml?r1=1.4&r2=1.5&diff_format=u Index: peardoc/fr/package/caching/cache-lite.xml diff -u peardoc/fr/package/caching/cache-lite.xml:1.4 peardoc/fr/package/caching/cache-lite.xml:1.5 --- peardoc/fr/package/caching/cache-lite.xml:1.4 Tue Jun 28 21:20:36 2005 +++ peardoc/fr/package/caching/cache-lite.xml Sat Dec 17 17:25:32 2005 @@ -1,19 +1,18 @@ -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: moosh Status: ready --> -<!-- Credit: yannick --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> + <sect1 id="package.caching.cache-lite"> <title>Cache_Lite</title> <para> - Cache_Lite fournit un système de cache rapide, + Cache_Lite fournit un système de cache rapide, léger et sécurisé. - Il est optimisé pour les conteneurs de fichiers et protège contre les corruptions dû au cache (car il utilise les verrous de fichiers et/ou des tests de hash). </para> - + &package.caching.cache-lite.intro; &package.caching.cache-lite.cache-lite.cache-lite; @@ -27,17 +26,19 @@ &package.caching.cache-lite.cache-lite.getmemorycachingstate; &package.caching.cache-lite.cache-lite.lastmodified; &package.caching.cache-lite.cache-lite.raiseerror; - + &package.caching.cache-lite.cache-lite-output.cache-lite-output; &package.caching.cache-lite.cache-lite-output.start; &package.caching.cache-lite.cache-lite-output.end; - + &package.caching.cache-lite.cache-lite-function.cache-lite-function; &package.caching.cache-lite.cache-lite-function.call; - + &package.caching.cache-lite.cache-lite-function.drop; + &package.caching.cache-lite.cache-lite-file.cache-lite-file; &package.caching.cache-lite.cache-lite-file.get; </sect1> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -56,4 +57,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml diff -u peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml:1.3 peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml:1.4 --- peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml:1.3 Fri Jun 24 15:10:26 2005 +++ peardoc/fr/package/database/db-dataobject/intro-autobuilding.xml Sat Dec 17 17:25:32 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> + <refentry id="package.database.db-dataobject.intro-autobuilding"> <refnamediv> <refname>Construction automatique et schéma de base de données</refname> @@ -54,6 +55,11 @@ Celà lira votre fichier de configuration et génèrera tous les classes de base ainsi que les fichiers de définitions de données. </para> + <para> + Depuis la version 1.5, vous pouvez utiliser l'option "proxy = full", ce qui fera + que DataObjects créera des classes et des schémas à la volée, plutôt que d'utiliser + un fichier ini ou des classes de pré-construction. + </para> </refsect1> <refsect1> <title>définition de la classe par défaut</title> @@ -94,7 +100,6 @@ ###END_AUTOCODE } - ]]> </programlisting> </example> @@ -142,26 +147,25 @@ changements risqueraient d'être perdus lors de la regénération). Vous pouvez effacer les clés d'une table en utilisant l'option de configuration "sequence_{table} = key" ou - en définissant la méthode sequenceKey() de votre classe étendue. + en définissant la méthode sequenceKey() de votre classe étendue. <example> <title>Fichier de configuration de base de données</title> - <programlisting role="ini"><![CDATA[ - + <programlisting role="ini"> +<![CDATA[ [group] id = 129 -name = 130 -grp_owner = 129 -official = 130 -street = 130 +name = 130 +grp_owner = 129 +official = 130 +street = 130 postcode = 130 -city = 130 -homepage = 130 -email = 130 -extra = 130 +city = 130 +homepage = 130 +email = 130 +extra = 130 [group__keys] -id = N - +id = N ]]> </programlisting> </example> @@ -174,12 +178,12 @@ </para> </refsect1> - + <refsect1> <title>Alternatives à l'utilisation d'un fichier de schéma</title> <para> Il est possible d'utiliser DataObjects sans fichier de schéma ; cela, - de deux façons : + de deux façons : <itemizedlist> <listitem> <simpara> @@ -196,12 +200,11 @@ </itemizedlist> La seconde méthode est détaillé dans la page des méthodes keys() and tables(). - </para> + </para> <para> Ci-dessous, une classe écrite manuellement qui n'utilise pas un fichier de schéma schema.ini. </para> - <para> Elle est prévue pour retourner une valeur depuis une méthode, plutôt qu'une variable objet, donc, l'affichage de print_r(), @@ -231,14 +234,12 @@ var $homepage; // string var $email; // string var $extra; // blob - - + // these are usefull to be consistant with a autogenerated file. - + /* Static get */ function staticGet($k,$v=NULL) { return DB_DataObject::staticGet('DataObjects_Grp',$k,$v); } - // now define your table structure. // key is column name, value is type function table() { @@ -252,17 +253,13 @@ 'photo' => DB_DATAOBJECT_STR + DB_DATAOBJECT_BLOB, ); } - + // now define the keys. function keys() { return array('id'); } - - - -} - +} ]]> </programlisting> </example> @@ -288,4 +285,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db-dataobject/intro-configuration.xml?r1=1.2&r2=1.3&diff_format=u Index: peardoc/fr/package/database/db-dataobject/intro-configuration.xml diff -u peardoc/fr/package/database/db-dataobject/intro-configuration.xml:1.2 peardoc/fr/package/database/db-dataobject/intro-configuration.xml:1.3 --- peardoc/fr/package/database/db-dataobject/intro-configuration.xml:1.2 Sun Nov 7 19:42:13 2004 +++ peardoc/fr/package/database/db-dataobject/intro-configuration.xml Sat Dec 17 17:25:32 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> + <refentry id="package.database.db-dataobject.intro-configuration"> <refnamediv> <refname>Options de configuration</refname> @@ -8,7 +9,7 @@ Définition des options par défaut d'accès à une base de données </refpurpose> </refnamediv> - + <refsect1> <title>Configuration</title> <para> @@ -63,16 +64,10 @@ </example> </refsect1> - -<!-- -Config Options ---> - - <refsect1> <title>Options de configuration - Requis</title> <variablelist> - + <varlistentry> <term> <parameter>database</parameter> @@ -84,7 +79,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>schema_location</parameter> @@ -105,7 +100,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>require_prefix</parameter> @@ -139,20 +134,15 @@ </para> </listitem> </varlistentry> - + </variablelist> </refsect1> -<!-- -Config Options - Optional ---> - - <refsect1> <title>Options de configuration - Optionnelles</title> <variablelist> - + <varlistentry> <term> <parameter>sequence_{table}</parameter> @@ -174,7 +164,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>ignore_sequence_keys</parameter> @@ -188,7 +178,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>debug</parameter> @@ -213,8 +203,7 @@ </para> </listitem> </varlistentry> - - + <varlistentry> <term> <parameter>dont_die</parameter> @@ -232,15 +221,48 @@ </para> </listitem> </varlistentry> - - </variablelist> - - </refsect1> + <varlistentry> + <term> + <parameter>quote_identifiers</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Pour forcer l'ajout de quote aux identifiants dans les requêtes SQL, définissez + à 1 + <example> + <title>Requête générée avec et sans quote_identifiers</title> + <programlisting role="ini"> +<![CDATA[ +quote_identifiers = 1; +SELECT 'somecol' FROM 'sometable' WHERE 'somevalue'=1; -<!-- -Config Options - Multi Database ---> +quote_identifiers = 0; +SELECT somecol FROM sometable WHERE somevalue=1; + +]]> + </programlisting> + </example> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>proxy</parameter> + <type>string</type> + </term> + <listitem> + <para> + Ceci active la construction des classe et des classes ini à la volée, plutôt + que ce soit vous qui écriviez le code. (actuellement, la seule valeur supportée est + "full", qui génère le schéma des données et la classe par défaut) + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> <refsect1> <title>Opitons de configuration - Bases de données multiples (optionnel)</title> @@ -268,7 +290,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>table_*</parameter> @@ -291,22 +313,14 @@ </para> </listitem> </varlistentry> - </variablelist> - </refsect1> -<!-- - - Config Options - BUILDER - ---> - <refsect1> <title>Options de configuration - Construction</title> - + <variablelist> - + <varlistentry> <term> <parameter>class_location</parameter> @@ -340,7 +354,7 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>extends_location</parameter> @@ -358,11 +372,11 @@ </para> </listitem> </varlistentry> - + <varlistentry> <term> <parameter>generator_class_rewrite</parameter> - <type>dossier</type> + <type>boolean</type> </term> <listitem> <para> @@ -373,9 +387,6 @@ </listitem> </varlistentry> - - - <varlistentry> <term> <parameter>build_views</parameter> @@ -385,21 +396,75 @@ <para> Postgres (et surement d'autres) vous permet de traiter les vues comme des tables normales (i.e. insert/update/delete etc. fonctionne sur ces tables), - vous pouvez utilisez cette option pour générer - les fichiers pour toutes les vues de la base de données. + vous pouvez utilisez cette option pour générer + les fichiers pour toutes les vues de la base de données. </para> <para> - Note : Vous devez spécifier les clés manuellement dans les classes générées (i.e. - définission des méthodes keys() et sequenceKey() ), car le générateur - ne peut pas deviner quelles sont les clés préférées. - </para> + Note : Vous devez spécifier les clés manuellement dans les classes générées (i.e. + définission des méthodes keys() et sequenceKey() ), car le générateur + ne peut pas deviner quelles sont les clés préférées. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_include_regex</parameter> + <type>string</type> + </term> + <listitem> + <para> + Si vous ne voulez générer que les classes et les entrées ini pour des tables spécifiques, + vous pouvez utiliser ce aramètre pour construire un masque, seules les tables avec des noms + correspondant à ce masque seront générées, par exemple /mytables_.*/ + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_exclude_regex</parameter> + <type>string</type> + </term> + <listitem> + <para> + Si vous voulez explicitement prévenir la génération des classes et des entrées ini pour des tables + spécifiques, vous pouvez utiliser ce paramètre pour construire un masque, toutes les tables + qui correspondent à ce masque ne seront pas générées, par exemple /private_tables_.*/ + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_novars</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Si &true;, le générateur n'écrira pas de définition privé ou de variable + pour les colonnes, donc, vous pouvez surcharger get/set. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>generator_add_validate_stubs</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Si &true; le générateur insérera un / (ou l'ajoute aux fichiers existants) + pour les méthodes valides. + </para> </listitem> </varlistentry> - + </variablelist> - </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -418,4 +483,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db/db/iserror.xml?r1=1.5&r2=1.6&diff_format=u Index: peardoc/fr/package/database/db/db/iserror.xml diff -u peardoc/fr/package/database/db/db/iserror.xml:1.5 peardoc/fr/package/database/db/db/iserror.xml:1.6 --- peardoc/fr/package/database/db/db/iserror.xml:1.5 Wed Jul 7 21:22:04 2004 +++ peardoc/fr/package/database/db/db/iserror.xml Sat Dec 17 17:25:32 2005 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.15 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> <refentry id="package.database.db.db.iserror"> <refnamediv> <refname>DB::isError()</refname> <refpurpose>Détermine si une variable est un objet DB_Error</refpurpose> </refnamediv> - + <refsynopsisdiv> <funcsynopsis> <funcprototype> @@ -18,15 +18,20 @@ </funcprototype> </funcsynopsis> </refsynopsisdiv> - + <refsect1 id="package.database.db.db.iserror.desc"> &title.desc; <para> Vérifie si le code de retour d'une méthode de DB est un objet &class.db-error; ou non. </para> + <para> + Il est préférable d'utiliser + <function>PEAR::isError</function> + au lieu de la fonction <function>isError</function> spécifique à DB. + </para> </refsect1> - + <refsect1 id="package.database.db.db.iserror.parameter"> &title.param; <para> @@ -45,6 +50,7 @@ </variablelist> </para> </refsect1> + <refsect1 id="package.database.db.db.iserror.return"> &title.returns; <para> @@ -52,7 +58,7 @@ est un objet &class.db-error; </para> </refsect1> - + <refsect1 id="package.database.db.db.iserror.note"> &title.note; ¬e.shouldstatic; @@ -68,7 +74,7 @@ require_once 'DB.php'; $db =& DB::connect('pgsql://usr:pw@localhost/dbnam'); -if (DB::isError($db)) { +if (PEAR::isError($db)) { die($db->getMessage()); } ?> @@ -96,4 +102,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db/db-result/fetchinto.xml?r1=1.2&r2=1.3&diff_format=u Index: peardoc/fr/package/database/db/db-result/fetchinto.xml diff -u peardoc/fr/package/database/db/db-result/fetchinto.xml:1.2 peardoc/fr/package/database/db/db-result/fetchinto.xml:1.3 --- peardoc/fr/package/database/db/db-result/fetchinto.xml:1.2 Wed Jul 7 21:22:04 2004 +++ peardoc/fr/package/database/db/db-result/fetchinto.xml Sat Dec 17 17:25:32 2005 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.27 Maintainer: didou Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.28 Maintainer: didou Status: ready --> <refentry id="package.database.db.db-result.fetchinto"> <refnamediv> <refname>DB_result::fetchInto()</refname> <refpurpose>Récupère une ligne dans une variable</refpurpose> </refnamediv> - + <refsynopsisdiv> <funcsynopsis> <funcprototype> @@ -25,7 +25,7 @@ </funcprototype> </funcsynopsis> </refsynopsisdiv> - + <refsect1 id="package.database.db.db-result.fetchinto.desc"> &title.desc; <para> @@ -34,7 +34,7 @@ Les données peuvent être formatées en tableau ou en objet. </para> </refsect1> - + <refsect1 id="package.database.db.db-result.fetchinto.parameter"> &title.param; <para> @@ -91,14 +91,15 @@ </term> <listitem> <para> - le numéro de la ligne à récupérer + le numéro de la ligne à récupérer. + Notez que 0 retourne la première ligne, 1 retourne la seconde, etc. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> - + <refsect1 id="package.database.db.db-result.fetchinto.return"> &title.returns; <para> @@ -107,7 +108,7 @@ un objet &class.db-error; en cas d'erreur </para> </refsect1> - + <refsect1 id="package.database.db.db-result.fetchinto.note"> &title.note; ¬e.notstatic; @@ -164,4 +165,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/database/db/db-result/numrows.xml?r1=1.3&r2=1.4&diff_format=u Index: peardoc/fr/package/database/db/db-result/numrows.xml diff -u peardoc/fr/package/database/db/db-result/numrows.xml:1.3 peardoc/fr/package/database/db/db-result/numrows.xml:1.4 --- peardoc/fr/package/database/db/db-result/numrows.xml:1.3 Sun Nov 7 19:42:13 2004 +++ peardoc/fr/package/database/db/db-result/numrows.xml Sat Dec 17 17:25:32 2005 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.21 Maintainer: didou Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> <refentry id="package.database.db.db-result.numrows"> <refnamediv> <refname>DB_result::numRows()</refname> <refpurpose>Retourne le nombre de lignes</refpurpose> </refnamediv> - + <refsynopsisdiv> <funcsynopsis> <funcprototype> @@ -16,14 +16,29 @@ </funcprototype> </funcsynopsis> </refsynopsisdiv> - + <refsect1 id="package.database.db.db-result.numrows.desc"> &title.desc; <para> Retourne le nombre de lignes dans le résultat. </para> + <warning> + <para> + Pour <literal>ibase</literal>, <literal>ifx</literal> et + <literal>oci8</literal>, cette méthode ne fonctionne que si + l'<link linkend="package.database.db.intro-portability">option + de portabilité</link> + <constant>DB_PORTABILITY_NUMROWS</constant> + est activée. De plus, pour <literal>ibase</literal> et + <literal>ifx</literal>, PEAR DB doit être à la version + 1.7.0 ou supérieure. + </para> + <para> + Ne fonctionne pas avec Microsoft Access. + </para> + </warning> </refsect1> - + <refsect1 id="package.database.db.db-result.numrows.return"> &title.returns; <para> @@ -31,7 +46,52 @@ ou un objet &class.db-error; en cas d'erreur </para> </refsect1> - + + <refsect1 id="package.database.db.db-result.numrows.return"> + &title.returns; + <para> + &type.int; - number of rows + or a &class.db-error; object on failure + </para> + </refsect1> + + <refsect1 id="package.database.db.db-result.numrows.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message d'erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_NOT_CAPABLE</constant></entry> + <entry> + DB backend not capable + </entry> + <entry> + Le driver ne supporte pas cette fonctionalité. + </entry> + <entry> + Soit vous prenez un autre système de base de données ou + vous activez + l'<link linkend="package.database.db.intro-portability">option + de portabilité</link> + <constant>DB_PORTABILITY_NUMROWS</constant>. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1 id="package.database.db.db-result.numrows.note"> &title.note; ¬e.notstatic; @@ -52,7 +112,7 @@ </programlisting> </example> </refsect1> - + <refsect1 id="package.database.db.db-result.numrows.see"> &title.see; <para> @@ -82,4 +142,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file