cvs: phpdoc-fr /reference/memcache reference.xml /reference/memcache/functions memcache-add.xml memcache-close.xml memcache-connect.xml
memcache-debug.xml memcache-decrement.xml memcache-delete.xml memcache-flush.xml memcache-get.xml memcache-getstats.xml memcache-getversion.xml
memcache-increment.xml memcache-pconnect.xml memcache-replace.xml memcache-set.xml

From: Date: Thu, 29 Dec 2005 06:21:15 +0000
Subject: cvs: phpdoc-fr /reference/memcache reference.xml /reference/memcache/functions memcache-add.xml memcache-close.xml memcache-connect.xml
memcache-debug.xml memcache-decrement.xml memcache-delete.xml memcache-flush.xml memcache-get.xml memcache-getstats.xml memcache-getversion.xml
memcache-increment.xml memcache-pconnect.xml memcache-replace.xml memcache-set.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-4742@lists.php.net to get a copy of this message
jsgoupil Thu Dec 29 06:21:15 2005 EDT Modified files: /phpdoc-fr/reference/memcache reference.xml /phpdoc-fr/reference/memcache/functions memcache-add.xml memcache-close.xml memcache-connect.xml memcache-debug.xml memcache-decrement.xml memcache-delete.xml memcache-flush.xml memcache-get.xml memcache-getstats.xml memcache-getversion.xml memcache-increment.xml memcache-pconnect.xml memcache-replace.xml memcache-set.xml Log: Sync with EN

http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/reference.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/memcache/reference.xml diff -u phpdoc-fr/reference/memcache/reference.xml:1.5 phpdoc-fr/reference/memcache/reference.xml:1.6 --- phpdoc-fr/reference/memcache/reference.xml:1.5 Mon Sep 5 16:10:57 2005 +++ phpdoc-fr/reference/memcache/reference.xml Thu Dec 29 06:21:14 2005 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Purpose: remote.other --> <!-- Membership: pecl, external --> - +<!-- Reviewed: no --> <reference id="ref.memcache"> <title>Fonctions Memcache</title> <titleabbrev>Memcache</titleabbrev> @@ -18,11 +18,6 @@ de données dans les applications web dynamiques. </para> <para> - Ce module n'a pas un support natif des serveurs multiples, mais vous pouvez - tout de même l'implémenter vous-même dans vos applications. Établir - plusieurs connexions memcache, définir les priorités pour chaque serveur, etc. - </para> - <para> Plus d'informations concernant <literal>Memcache</literal> peuvent être consultées sur <ulink url="&url.memcache;">&url.memcache;</ulink>. </para> http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-add.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-add.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-add.xml:1.3 phpdoc-fr/reference/memcache/functions/memcache-add.xml:1.4 --- phpdoc-fr/reference/memcache/functions/memcache-add.xml:1.3 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-add.xml Thu Dec 29 06:21:15 2005 @@ -1,12 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-add"> <refnamediv> <refname>Memcache::add</refname> <refpurpose>Ajout d'un élément au serveur</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::add</methodname> @@ -15,22 +17,78 @@ <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>expire</parameter></methodparam> </methodsynopsis> + <para> - <function>Memcache::add</function> stocke la variable <parameter>var</parameter> + <function>Memcache::add</function> enregistre la variable <parameter>var</parameter> avec la clé <parameter>key</parameter> seulement si cette clé n'existe pas encore sur le serveur. - <function>memcache::add</function> retourne &false; si cette clé existe déjà. + Vous pouvez également utiliser la fonction <function>Memcache_add</function>. + </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + La clé qui sera associée avec l'élément. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>var</parameter></term> + <listitem> + <para> + La variable à enregistrer. Les chaînes de caractères et les entiers + sont enregistrés comme tels, les autres types sont enregistrés de + manière sérialisée. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + Utilisez <constant>MEMCACHE_COMPRESSED</constant> pour enregistrer + l'élément compressé (utilise zlib). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>expire</parameter></term> + <listitem> + <para> + Temps d'expiration pour l'élément. S'il égal &zero;, l'élément n'expirera + jamais. Vous pouvez aussi utiliser un timestamp de unix ou un nombre de + seconde en commençant par la date d'aujourd'hui, mais dans le dernier + cas, le nombre de secondes ne doit pas excéder 2592000 (30 jours). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + Retourne &false; si cette clé existe déjà. Pour le reste, la fonction <function>Memcache::add</function> se comporte de façon similaire à la fonction <function>Memcache::set</function>. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> - Vous pouvez également utiliser la fonction - <function>Memcache_add</function>. - Regardez l'exemple ci-dessous. - </para> - <example> - <title>Exemple avec <function>Memcache::add</function></title> - <programlisting role="php"> + <example> + <title>Exemple avec <function>Memcache::add</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -44,18 +102,21 @@ ?> ]]> - </programlisting> - </example> - <para> - <function>Memcache::add</function> retourne &true; en cas de succès - ou &false; en cas d'échec. + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::set</function> et - <function>Memcache::replace</function>. + <simplelist> + <member><function>Memcache::set</function></member> + <member><function>Memcache::replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-close.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-close.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-close.xml:1.4 phpdoc-fr/reference/memcache/functions/memcache-close.xml:1.5 --- phpdoc-fr/reference/memcache/functions/memcache-close.xml:1.4 Mon Dec 12 18:23:52 2005 +++ phpdoc-fr/reference/memcache/functions/memcache-close.xml Thu Dec 29 06:21:15 2005 @@ -1,31 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-close"> <refnamediv> <refname>Memcache::close</refname> <refpurpose>Ferme la connexion avec le serveur <literal>Memcache</literal></refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::close</methodname> <void/> </methodsynopsis> + <para> <function>Memcache::close</function> ferme la connexion au serveur <literal>Memcache</literal>. Cette fonction ne ferme pas les connexions persistantes qui seront fermées uniquement lors du redémarrage du serveur web. + Vous pouvez également utiliser la fonction <function>memcache_close</function>. </para> + + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Vous pouvez également utiliser la fonction - <function>memcache_close</function>. - Regardez l'exemple ci-dessous. + &return.success; </para> - <example> - <title>Exemple avec <function>Memcache::close</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::close</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -46,17 +58,21 @@ ?> ]]> - </programlisting> - </example> - <para> - <function>Memcache::close</function> retourne &false; si une erreur survient. + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::connect</function> et - <function>Memcache::pconnect</function>. + <simplelist> + <member><function>Memcache::connect</function></member> + <member><function>Memcache::pconnect</function></member> + </simplelist> </para> -</refsect1> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-connect.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-connect.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-connect.xml:1.6 phpdoc-fr/reference/memcache/functions/memcache-connect.xml:1.7 --- phpdoc-fr/reference/memcache/functions/memcache-connect.xml:1.6 Mon Dec 12 18:23:52 2005 +++ phpdoc-fr/reference/memcache/functions/memcache-connect.xml Thu Dec 29 06:21:15 2005 @@ -1,13 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-connect"> <refnamediv> <refname>Memcache::connect</refname> <refpurpose>Ouvre une connexion avec le serveur <literal>Memcache</literal></refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::connect</methodname> @@ -15,33 +17,67 @@ <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::connect</function> établie une connexion avec le serveur - de cache <literal>Memcache</literal>. Les paramètres - <parameter>host</parameter> et <parameter>port</parameter> - désignent respectivement l'hôte et le port où le serveur - <literal>Memcache</literal> attend des connexions. - Le paramètre <parameter>port</parameter> est optionnel, la valeur par - défaut est 11211. Vous pouvez également définir un paramètre - <parameter>timeout</parameter> (en secondes), qui sera utiliser lors de la connexion avec - les serveur. Faites attention si vous changez la valeur par défaut : - vous pouvez perdre tous les avantages du système de cache si votre connexion - est trop lente. - </para> - <para> + de cache <literal>Memcache</literal>. La connexion, qui a été ouverte en utilisant la fonction <function>Memcache::connect</function> sera automatiquement fermée à la fin de votre script. Vous pouvez néanmoins la refermer en utilisant la fonction <function>Memcache::close</function>. + Vous pouvez également utiliser la fonction <function>memcache_connect</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Vous pouvez également utiliser la fonction - <function>memcache_connect</function>. - Regardez l'exemple ci-dessous. + <variablelist> + <varlistentry> + <term><parameter>host</parameter></term> + <listitem> + <para> + Pointe à l'hôte où memcache écoute pour des connexions. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>port</parameter></term> + <listitem> + <para> + Pointe au port où memcache écoute pour des connexions. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>timeout</parameter></term> + <listitem> + <para> + Valeur en seconde qui sera utilisée pour se connecter au daemon. + Pensez-y deux fois avant de changer la valeur par défaut d'une seconde + - vous pourriez perdre tous les avantages de l'utilisation de la cache + si votre connexion est trop lente. + </para> + </listitem> + </varlistentry> + </variablelist> </para> - <example> - <title>Exemple avec <function>Memcache::connect</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::connect</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -56,17 +92,21 @@ ?> ]]> - </programlisting> - </example> - <para> - &return.success; + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::pconnect</function> et - <function>Memcache::close</function>. + <simplelist> + <member><function>Memcache::pconnect</function></member> + <member><function>Memcache::close</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-debug.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-debug.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-debug.xml:1.4 phpdoc-fr/reference/memcache/functions/memcache-debug.xml:1.5 --- phpdoc-fr/reference/memcache/functions/memcache-debug.xml:1.4 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-debug.xml Thu Dec 29 06:21:15 2005 @@ -1,31 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.memcache-debug"> <refnamediv> <refname>memcache_debug</refname> - <refpurpose>Active ou non l'affichage des informations de déboguage</refpurpose> + <refpurpose>Active ou non l'affichage des informations de débogage</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>memcache_debug</methodname> - <methodparam><type>int</type><parameter>on_off</parameter></methodparam> + <methodparam><type>bool</type><parameter>on_off</parameter></methodparam> </methodsynopsis> + <para> <function>memcache_debug</function> active l'affichage des informations - de déboguage si le paramètre <parameter>on_off</parameter> vaut 1 et le désactive - s'il vaut 0. + de débogage si le paramètre <parameter>on_off</parameter> vaut &true; et le désactive + s'il vaut &false;. + <note> + <para> + <function>memcache_debug</function> est accessible uniquement si &php; + a été compilé avec l'option <option>--enable-debug</option> et retournera + toujours &true; dans ce cas. Sinon, cette fonction n'aura aucun effet et + retournera toujours &false;. + </para> + </note> + </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>on_off</parameter></term> + <listitem> + <para> + Active l'affichage de débogue si égal à &true;. + Désactive l'affichage de débogue si égal à &false;. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si &php; était compilé avec l'option --enable-debug, + autrement retourne &false;. </para> - <note> - <para> - <function>memcache_debug</function> est accessible uniquement si &php; - a été compilé avec l'option <option>--enable-debug</option> et retournera - toujours &true; dans ce cas. Sinon, cette fonction n'aura aucun effet et - retournera toujours &false;. - </para> - </note> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-decrement.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-decrement.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-decrement.xml:1.3 phpdoc-fr/reference/memcache/functions/memcache-decrement.xml:1.4 --- phpdoc-fr/reference/memcache/functions/memcache-decrement.xml:1.3 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-decrement.xml Thu Dec 29 06:21:15 2005 @@ -1,54 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-decrement"> <refnamediv> <refname>Memcache::decrement</refname> <refpurpose>Décrémente la valeur d'un élément</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>Memcache::decrement</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>value</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::decrement</function> décrémente la valeur de l'élément par <parameter>value</parameter>. De la même façon que la fonction <function>memcache::increment</function>, la valeur courante de l'élément est tout d'abord convertie en numérique et seulement ensuite, on soustrait la valeur <parameter>value</parameter>. + <note> + <para> + La nouvelle valeur de l'élément ne peut être inférieure à zéro. + </para> + </note> + <note> + <para> + N'utilisez pas la fonction <function>Memcache::decrement</function> avec les éléments + stockés compressés. Dans ce cas, l'appel à la fonction + <function>Memcache::get</function> échouera. + </para> + </note> + Vous pouvez également utiliser la fonction <function>memcache_decrement</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Le paramètre <parameter>value</parameter> est optionnel. Par défaut, il vaut 1. + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + Clé de l'élément à décrémenter. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + Décrémente l'élément par <parameter>value</parameter>. Optionnel et vaut + par défaut 1. + </para> + </listitem> + </varlistentry> + </variablelist> </para> - <note> - <para> - La nouvelle valeur de l'élément ne peut être inférieure à zéro. - </para> - </note> - <note> - <para> - N'utilisez pas la fonction <function>Memcache::decrement</function> avec les éléments - stockés compressés. Dans ce cas, l'appel à la fonction - <function>Memcache::get</function> échouera. - </para> - </note> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Vous pouvez également utiliser la fonction - <function>memcache_decrement</function>. - Regardez l'exemple ci-dessous. + Retourne la valeur du nouvel élément en cas de succès ou &false; en cas + d'échec. </para> - <example> - <title>Exemple avec <function>Memcache::decrement</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::decrement</function></title> + <programlisting role="php"> <![CDATA[ <?php /* API proécédurale */ $memcache_obj = memcache_connect('memcache_host', 11211); -/* decrement item by 2 */ +/* décrémentation de l'élément par 2 */ $new_value = memcache_decrement($memcache_obj, 'test_item', 2); /* API orientée objet */ @@ -60,20 +95,19 @@ ]]> </programlisting> </example> - <para> - <function>Memcache::decrement</function> <emphasis>ne crée pas</emphasis> - l'élément s'il n'existe pas. - </para> - <para> - <function>Memcache::decrement</function> retourne la nouvelle valeur de l'élément - en cas de succès ou &false; en cas d'échec. </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::increment</function> et - <function>Memcache::replace</function>. + <simplelist> + <member><function>Memcache::increment</function></member> + <member><function>Memcache::replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-delete.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-delete.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-delete.xml:1.5 phpdoc-fr/reference/memcache/functions/memcache-delete.xml:1.6 --- phpdoc-fr/reference/memcache/functions/memcache-delete.xml:1.5 Mon Nov 28 04:00:59 2005 +++ phpdoc-fr/reference/memcache/functions/memcache-delete.xml Thu Dec 29 06:21:15 2005 @@ -1,31 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-delete"> <refnamediv> <refname>Memcache::delete</refname> <refpurpose>Efface un élément du serveur de cache</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::delete</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::delete</function> efface l'élément identifié par la clé <parameter>key</parameter>. Si le paramètre <parameter>timeout</parameter> est spécifié, l'élément expirera après <parameter>timeout</parameter> secondes. + Vous pouvez également utiliser la fonction <function>memcache_delete</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Vous pouvez également utiliser la fonction - <function>memcache_delete</function>. - Regardez l'exemple ci-dessous. + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>timeout</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; </para> - <example> - <title>Exemple avec <function>Memcache::delete</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::delete</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -43,12 +77,21 @@ ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - &return.success; + <simplelist> + <member><function>Memcache::set</function></member> + <member><function>Memcache::replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-flush.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-flush.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-flush.xml:1.3 phpdoc-fr/reference/memcache/functions/memcache-flush.xml:1.4 --- phpdoc-fr/reference/memcache/functions/memcache-flush.xml:1.3 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-flush.xml Thu Dec 29 06:21:15 2005 @@ -1,32 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-flush"> <refnamediv> <refname>Memcache::flush</refname> <refpurpose>Efface tous les éléments existant sur le serveur de cache</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::flush</methodname> <void/> </methodsynopsis> + <para> <function>Memcache::flush</function> invalide immédiatement tous les éléments existant sur le serveur de cache. <function>Memcache::flush</function> ne libère aucune ressource actuellement, il marque uniquement tous les éléments comme ayant expirés, donc la mémoire occupée sera réutilisée avec de nouveaux éléments. + Vous pouvez également utiliser la fonction <function>memcache_flush</function>. </para> - <para> - Vous pouvez également utiliser la fonction - <function>memcache_flush</function>. - Regardez l'exemple ci-dessous. + + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; </para> - <example> - <title>Exemple avec <function>Memcache::flush</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::flush</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -44,12 +56,11 @@ ?> ]]> - </programlisting> - </example> - <para> - &return.success; + </programlisting> + </example> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-get.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-get.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-get.xml:1.6 phpdoc-fr/reference/memcache/functions/memcache-get.xml:1.7 --- phpdoc-fr/reference/memcache/functions/memcache-get.xml:1.6 Sat Jun 25 17:45:35 2005 +++ phpdoc-fr/reference/memcache/functions/memcache-get.xml Thu Dec 29 06:21:15 2005 @@ -1,29 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-get"> <refnamediv> <refname>Memcache::get</refname> <refpurpose>Récupère un élément du serveur de cache</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>Memcache::get</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> </methodsynopsis> <methodsynopsis> - <type>string</type><methodname>Memcache::get</methodname> + <type>array</type><methodname>Memcache::get</methodname> <methodparam><type>array</type><parameter>keys</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::get</function> retourne les données précédemment stockées dans l'élément identifié par la clé <parameter>key</parameter> s'il existe sur le serveur au moment de l'appel. </para> - <example> - <title>Exemple avec <function>Memcache::get</function></title> - <programlisting role="php"> + + <para> + Vous pouvez passer un tableau de clés à la fonction + <function>Memcache::get</function> pour obtenir un tableau de valeurs. Le + tableau résultant contiendra seulement les paires de clé-valeur trouvées. + </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; associée avec le paramètre <parameter>key</parameter> + ou &false; en cas d'échec ou si <parameter>key</parameter> n'a pas été + trouvé. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::get</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -53,13 +92,11 @@ ?> ]]> - </programlisting> - </example> - <para> - <function>Memcache::get</function> retourne &false; en cas d'échec ou - si la clé <parameter>key</parameter> n'a pas été trouvée. + </programlisting> + </example> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-getstats.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-getstats.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-getstats.xml:1.2 phpdoc-fr/reference/memcache/functions/memcache-getstats.xml:1.3 --- phpdoc-fr/reference/memcache/functions/memcache-getstats.xml:1.2 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-getstats.xml Thu Dec 29 06:21:15 2005 @@ -1,35 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-getStats"> <refnamediv> <refname>Memcache::getStats</refname> <refpurpose>Lit les statistiques du serveur</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>Memcache::getStats</methodname> <void/> </methodsynopsis> + <para> <function>Memcache::getStats</function> retourne un tableau associatif avec les statistiques du serveur. Les index du tableau correspondent aux paramètres de statistiques, et la valeur associée est la valeur de ces statistiques. - </para> - <para> Vous pouvez aussi utiliser la fonction <function>memcache_get_stats</function>. </para> + + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - <function>Memcache::getstats</function> retourne &false; en cas d'erreur. - error. + Retourne un tableau associatif des statistiques d'un serveur ou &false; en + cas d'erreur. </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::getVersion</function>. + <simplelist> + <member><function>Memcache::getVersion</function></member> + <member><function>Memcache::getExtendedStats</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-getversion.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-getversion.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-getversion.xml:1.2 phpdoc-fr/reference/memcache/functions/memcache-getversion.xml:1.3 --- phpdoc-fr/reference/memcache/functions/memcache-getversion.xml:1.2 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-getversion.xml Thu Dec 29 06:21:15 2005 @@ -1,28 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-getVersion"> <refnamediv> <refname>Memcache::getVersion</refname> <refpurpose>Retourne le numéro de version du serveur</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>Memcache::getVersion</methodname> <void/> </methodsynopsis> + <para> <function>Memcache::getVersion</function> retourne une chaîne avec le numéro de version du serveur. + Vous pouvez aussi utiliser la fonction <function>memcache_get_version</function>. </para> + + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Vous pouvez aussi utiliser la fonction <function>memcache_get_version</function>. - Voyez l'exemple ci-dessous. + Retourne une &string; du numéro de version de serveur ou &false; en cas + d'erreur. </para> - <example> - <title>Exemple avec <function>Memcache::getVersion</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::getVersion</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -37,16 +51,21 @@ ?> ]]> - </programlisting> - </example> - <para> - <function>Memcache::getVersion</function> retourne &false; en cas d'erreur. + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::getStats</function>. + <simplelist> + <member><function>Memcache::getExtendedStats</function></member> + <member><function>Memcache::getStats</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-increment.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-increment.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-increment.xml:1.3 phpdoc-fr/reference/memcache/functions/memcache-increment.xml:1.4 --- phpdoc-fr/reference/memcache/functions/memcache-increment.xml:1.3 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-increment.xml Thu Dec 29 06:21:15 2005 @@ -1,18 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-increment"> <refnamediv> <refname>Memcache::increment</refname> <refpurpose>Incrément la valeur d'un élément</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="descripiton"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>Memcache::increment</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>value</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::increment</function> incrémente la valeur d'un élément identifié par la clé <parameter>key</parameter> par la valeur @@ -20,25 +23,59 @@ <parameter>key</parameter> n'est pas de type numérique et ne peut être converti en nombre, la valeur de cette élément sera défini à <parameter>value</parameter>. + <function>Memcache::increment</function> <emphasis>ne crée pas</emphasis> + un élément s'il n'existe pas. + <note> + <para> + N'utilisez pas <function>memcache::increment</function> avec les éléments + stockés compressés. Dans ce cas, l'appel à la fonction + <function>Memcache::get</function> échouera. + </para> + </note> + Vous pouvez également utiliser la fonction <function>memcache_increment</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Le paramètre <parameter>value</parameter> est optionnel. Par défaut, il vaut 1. + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + Clé de l'élément à incrémenter. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + Incrémente l'élément par <parameter>value</parameter>. Optionnel et vaut + par défaut 1. + </para> + </listitem> + </varlistentry> + </variablelist> </para> - <note> - <para> - N'utilisez pas <function>memcache::increment</function> avec les éléments - stockés compressés. Dans ce cas, l'appel à la fonction - <function>Memcache::get</function> échouera. - </para> - </note> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Vous pouvez également utiliser la fonction - <function>memcache_increment</function>. - Regardez l'exemple ci-dessous. + Retourne la valeur du nouvel élément en cas de succès ou &false; en cas + d'échec. </para> - <example> - <title>Exemple avec <function>Memcache::increment</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::increment</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -55,22 +92,21 @@ ?> ]]> - </programlisting> - </example> - <para> - <function>Memcache::increment</function> retourne la nouvelle valeur de l'élément - en cas de succès ou &false; en cas d'échec. - </para> - <para> - <function>Memcache::increment</function> <emphasis>ne crée pas</emphasis> - l'élément s'il n'existe pas. + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::decrement</function> et - <function>Memcache::replace</function>. + <simplelist> + <member><function>Memcache::decrement</function></member> + <member><function>Memcache::replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-pconnect.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-pconnect.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-pconnect.xml:1.3 phpdoc-fr/reference/memcache/functions/memcache-pconnect.xml:1.4 --- phpdoc-fr/reference/memcache/functions/memcache-pconnect.xml:1.3 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-pconnect.xml Thu Dec 29 06:21:15 2005 @@ -1,12 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-pconnect"> <refnamediv> <refname>Memcache::pconnect</refname> <refpurpose>Ouvre un connexion persistante à un serveur de cache</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::pconnect</methodname> @@ -14,21 +16,66 @@ <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::pconnect</function> est similaire à la fonction <function>Memcache::connect</function> avec la différence que la connexion sera persistante. Ce type de connexion n'est pas fermé à la fin du script et par la fonction <function>Memcache::close</function>. + Vous pouvez également utiliser la fonction <function>memcache_pconnect</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Vous pouvez également utiliser la fonction - <function>memcache_pconnect</function>. - Regardez l'exemple ci-dessous. + <variablelist> + <varlistentry> + <term><parameter>host</parameter></term> + <listitem> + <para> + Pointe à l'hôte où memcache écoute pour des connexions. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>port</parameter></term> + <listitem> + <para> + Pointe au port où memcache écoute pour des connexions. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>timeout</parameter></term> + <listitem> + <para> + Valeur en seconde qui sera utilisée pour se connecter au daemon. + Pensez-y deux fois avant de changer la valeur par défaut d'une seconde + - vous pourriez perdre tous les avantages de l'utilisation de la cache + si votre connexion est trop lente. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; </para> - <example> - <title>Exemple avec <function>Memcache::pconnect</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::pconnect</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -42,16 +89,20 @@ ?> ]]> - </programlisting> - </example> - <para> - &return.success; + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::connect</function>. + <simplelist> + <member><function>Memcache::connect</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-replace.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-replace.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-replace.xml:1.3 phpdoc-fr/reference/memcache/functions/memcache-replace.xml:1.4 --- phpdoc-fr/reference/memcache/functions/memcache-replace.xml:1.3 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/memcache/functions/memcache-replace.xml Thu Dec 29 06:21:15 2005 @@ -1,12 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-replace"> <refnamediv> <refname>Memcache::replace</refname> <refpurpose>Remplace une valeur d'un élément existant</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::replace</methodname> @@ -15,6 +17,7 @@ <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>expire</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::replace</function> est utilisé pour remplacer la valeur d'un élément identifié par la clé <parameter>key</parameter>. Dans le cas où @@ -22,15 +25,70 @@ la fonction <function>Memcache::replace</function> retournera &false;. Pour le reste, la fonction <function>Memcache::replace</function> fonctionne de la même façon que la fonction <function>Memcache::set</function>. + Vous pouvez également utiliser la fonction <function>memcache_replace</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Vous pouvez également utiliser la fonction - <function>memcache_replace</function>. - Regardez l'exemple ci-dessous. + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + La clé qui sera associée avec l'élément. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>var</parameter></term> + <listitem> + <para> + La variable à enregistrer. Les chaînes de caractères et les entiers + sont enregistrer comme tels, les autres types sont enregistrés de + manière sérialisée. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + Utilisez <constant>MEMCACHE_COMPRESSED</constant> pour enregistrer + l'élément compressé (utilise zlib). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>expire</parameter></term> + <listitem> + <para> + Temps d'expiration pour l'élément. S'il égal &zero;, l'élément n'expirera + jamais. Vous pouvez aussi utiliser un timestamp de unix ou un nombre de + seconde en commençant par la date d'aujourd'hui, mais dans le dernier + cas, le nombre de secondes ne doit pas excéder 2592000 (30 jours). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; </para> - <example> - <title>Exemple avec <function>Memcache::replace</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::replace</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -44,17 +102,21 @@ ?> ]]> - </programlisting> - </example> - <para> - &return.success; + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::set</function> et - <function>Memcache::add</function>. + <simplelist> + <member><function>Memcache::set</function></member> + <member><function>Memcache::add</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewcvs.cgi/phpdoc-fr/reference/memcache/functions/memcache-set.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/memcache/functions/memcache-set.xml diff -u phpdoc-fr/reference/memcache/functions/memcache-set.xml:1.4 phpdoc-fr/reference/memcache/functions/memcache-set.xml:1.5 --- phpdoc-fr/reference/memcache/functions/memcache-set.xml:1.4 Fri May 27 17:42:58 2005 +++ phpdoc-fr/reference/memcache/functions/memcache-set.xml Thu Dec 29 06:21:15 2005 @@ -1,12 +1,14 @@ <?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.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.Memcache-set"> <refnamediv> <refname>Memcache::set</refname> <refpurpose>Stocke des données dans le serveur de cache</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Memcache::set</methodname> @@ -15,6 +17,7 @@ <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>expire</parameter></methodparam> </methodsynopsis> + <para> <function>Memcache::set</function> stocke l'élément <parameter>var</parameter> avec la clé <parameter>key</parameter> sur le serveur de cache. @@ -22,27 +25,80 @@ d'expiration de l'élément. S'il vaut 0, l'élément n'expirera jamais (mais le serveur de cache ne garantie pas que cet élément sera toujours stocké, il peut être effacé du cache pour faire de la place à d'autres éléments). - </para> - <para> Vous pouvez utiliser la constante <constant>MEMCACHE_COMPRESSED</constant> comme valeur du paramètre <parameter>flag</parameter> si vous voulez utiliser la compression à la volée (utilisation de la bibliothèque zlib). + <note> + <para> + Souvenez-vous que les ressources (i.e. identifiant de fichiers ou de connexion) + ne peuvent pas être stockées dans le cache, car elles ne peuvent pas être + représentées linéairement. + </para> + </note> + Vous pouvez également utiliser la fonction <function>memcache_set</function>. </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + La clé qui sera associée avec l'élément. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>var</parameter></term> + <listitem> + <para> + La variable à enregistrer. Les chaînes de caractères et les entiers + sont enregistrés comme tels, les autres types sont enregistrés de + manière sérialisée. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + Utilisez <constant>MEMCACHE_COMPRESSED</constant> pour enregistrer + l'élément compressé (utilise zlib). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>expire</parameter></term> + <listitem> + <para> + Temps d'expiration pour l'élément. S'il égal &zero;, l'élément n'expirera + jamais. Vous pouvez aussi utiliser un timestamp de unix ou un nombre de + seconde en commençant par la date d'aujourd'hui, mais dans le dernier + cas, le nombre de secondes ne doit pas excéder 2592000 (30 jours). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Vous pouvez également utiliser la fonction - <function>memcache_set</function>. - Regardez l'exemple ci-dessous. + &return.success; </para> - <note> - <para> - Souvenez-vous que les ressources (i.e. identifiant de fichiers ou de connexion) - ne peuvent pas être stockées dans le cache, car elles ne peuvent pas être - représentées linéairement. - </para> - </note> - <example> - <title>Exemple avec <function>Memcache::set</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>Memcache::set</function></title> + <programlisting role="php"> <![CDATA[ <?php /* API procédurale */ @@ -62,11 +118,11 @@ ?> ]]> - </programlisting> - </example> - <example> - <title>Exemple avec <function>Memcache::set</function></title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Exemple avec <function>Memcache::set</function></title> + <programlisting role="php"> <![CDATA[ <?php /* API orientée objet */ @@ -87,17 +143,21 @@ ?> ]]> - </programlisting> - </example> - <para> - &return.success; + </programlisting> + </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>Memcache::add</function> et - <function>Memcache::replace</function>. + <simplelist> + <member><function>Memcache::add</function></member> + <member><function>Memcache::replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file @@ -119,4 +179,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 +-->
« previous php.doc.fr (#4742) next »