Files
doc-fr/reference/memcached/constants.xml
George Peter Banyard a4c0be9602 Update Memcached docs
2021-09-10 15:59:37 +01:00

769 lines
24 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 65f1e1978c89ba3ba24d8eff0907dedfac5fd5bb Maintainer: dams Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="memcached.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants;
<variablelist>
<varlistentry xml:id="memcached.constants.opt-compression">
<term><constant>Memcached::OPT_COMPRESSION</constant></term>
<listitem>
<para>
Active ou désactive la compression du contenu. Si elle est
activée, les éléments qui dépassent une taille (actuellement
100 octets), seront compressés durant le stockage, et
décompressés au déstockage, de manière transparente.</para>
<para>
Type : &boolean;, par défaut : &true;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-serializer">
<term><constant>Memcached::OPT_SERIALIZER</constant></term>
<listitem>
<para>
Spécifie la fonction de linéarisation à utiliser pour les valeurs non
scalaires. Les fonctions valides sont
<constant>Memcached::SERIALIZER_PHP</constant>
et <constant>Memcached::SERIALIZER_IGBINARY</constant>.
Le dernier n'est supporté que si memcached est configuré
avec l'option <literal>--enable-memcached-igbinary</literal>
et que l'extension <literal>igbinary</literal> est chargée.
</para>
<para>
Type : &integer;, par défaut :
<constant>Memcached::SERIALIZER_PHP</constant>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.serializer-php">
<term><constant>Memcached::SERIALIZER_PHP</constant></term>
<listitem>
<para>
La fonction de linéarisation par défaut de PHP.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.serializer-igbinary">
<term><constant>Memcached::SERIALIZER_IGBINARY</constant></term>
<listitem>
<para>
La fonction <link xlink:href="&url.igbinary;">igbinary</link>.
Au lieu d'une représentation textuelle, cette fonction stocke les
structures PHP dans un format compact et binaire, avec un gain
de temps et d'espace.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.serializer-json">
<term><constant>Memcached::SERIALIZER_JSON</constant></term>
<listitem>
<para>La fonction de linéarisation JSON.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-prefix-key">
<term><constant>Memcached::OPT_PREFIX_KEY</constant></term>
<listitem>
<para>
Cette option peut être utilisée pour créer un "domaine" pour vos clés.
La valeur spécifiée ici sera préfixée à chaque clé. Elle ne peut pas être
plus longue que <literal>128</literal> caractères, et réduira d'autant
la taille maximale de clé disponible. Le préfixe est appliqué uniquement
aux clés d'élément, et non pas aux clés de serveur.
</para>
<para>
Type : &string;, par défaut : <literal>""</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-hash">
<term><constant>Memcached::OPT_HASH</constant></term>
<listitem>
<para>
Spécifie l'algorithme de hachage utilisé pour les clé. Les valeurs valides
sont fournies avec les constantes <constant>Memcached::HASH_*</constant>.
Chaque algorithme de hachage a ses avantages et inconvénients. Utilisez
celui qui est donné par défaut, si vous ne comprenez pas, ou que peu vous
importe.
</para>
<para>
Type : &integer;, par défaut :
<constant>Memcached::HASH_DEFAULT</constant>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-default">
<term><constant>Memcached::HASH_DEFAULT</constant></term>
<listitem>
<para>
L'algorithme par défaut (<literal>Jenkins one-at-a-time</literal>)
de hachage.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-md5">
<term><constant>Memcached::HASH_MD5</constant></term>
<listitem>
<para>
L'algorithme de hachage par MD5
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-crc">
<term><constant>Memcached::HASH_CRC</constant></term>
<listitem>
<para>
L'algorithme de hachage par CRC
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-fnv1-64">
<term><constant>Memcached::HASH_FNV1_64</constant></term>
<listitem>
<para>
L'algorithme de hachage par FNV1_64
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-fnv1a-64">
<term><constant>Memcached::HASH_FNV1A_64</constant></term>
<listitem>
<para>
L'algorithme de hachage par FNV1_64A
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-fnv1-32">
<term><constant>Memcached::HASH_FNV1_32</constant></term>
<listitem>
<para>
L'algorithme de hachage par FNV1_32
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-fnv1a-32">
<term><constant>Memcached::HASH_FNV1A_32</constant></term>
<listitem>
<para>
L'algorithme de hachage par FNV1_32A
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-hsieh">
<term><constant>Memcached::HASH_HSIEH</constant></term>
<listitem>
<para>
L'algorithme de hachage par Hsieh
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.hash-murmur">
<term><constant>Memcached::HASH_MURMUR</constant></term>
<listitem>
<para>
L'algorithme de hachage par Murmur
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-distribution">
<term><constant>Memcached::OPT_DISTRIBUTION</constant></term>
<listitem>
<para>
Spécifie la méthode de distribution des clés sur les serveurs.
Actuellement, cette option supporte les modulo et le hachage cohérent.
Le hachage cohérent fournit la meilleure distribution, et permet
aux serveurs d'être ajouté au groupe avec un minimum de pertes de
cache.
</para>
<para>
Type : &integer;, par défaut :
<constant>Memcached::DISTRIBUTION_MODULA</constant>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.distribution-modula">
<term><constant>Memcached::DISTRIBUTION_MODULA</constant></term>
<listitem>
<para>
L'algorithme de distribution par modulo
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.distribution-consistent">
<term><constant>Memcached::DISTRIBUTION_CONSISTENT</constant></term>
<listitem>
<para>
L'algorithme de distribution par hachage cohérent
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-libketama-compatible">
<term><constant>Memcached::OPT_LIBKETAMA_COMPATIBLE</constant></term>
<listitem>
<para>
Active ou non la compatibilité avec le comportement type libketama.
Quand cette option est activée, l'algorithme de hachage est MD5,
et la distribution est le hachage cohérent. Ceci est pratique car
d'autres client qui utilisent libketama (Python, Ruby, etc.) avec
la même configuration serveur seront capables d'utiliser les mêmes
clés, de manière transparente.
</para>
<note>
<para>
Cette option est hautement recommandée, si vous voulez utiliser
le hachage cohérent, et il est probable qu'elle soit activée
par défaut dans de futures versions.
</para>
</note>
<para>
Type : &boolean;, par défaut : &false;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-buffer-writes">
<term><constant>Memcached::OPT_BUFFER_WRITES</constant></term>
<listitem>
<para>
Active ou non la bufferisation d'entrée / sortie. La bufferisation
fait que les commandes de stockage mettent en buffer, au lieu de
faire des envois. Toute action qui lit des données fait que le
buffer d'écriture est envoyé au serveur distant. La fermeture de la
connexion ou son arrêt vont aussi forcer l'envoi des données du
buffer.
</para>
<para>
Type : &boolean;, par défaut : &false;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-binary-protocol">
<term><constant>Memcached::OPT_BINARY_PROTOCOL</constant></term>
<listitem>
<para>
Activez cette option pour utiliser le protocole binaire.
Notez que vous ne pouvez pas changer cette option pour
une connexion déjà ouverte.
</para>
<para>
Type : &boolean;, par défaut : &false;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-no-block">
<term><constant>Memcached::OPT_NO_BLOCK</constant></term>
<listitem>
<para>
Active ou non les transferts asynchrones. Ceci est le mode de transfert
le plus rapide, pour les fonctions de stockage.
</para>
<para>Type : &boolean;, par défaut : &false;.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-noreply">
<term><constant>Memcached::OPT_NOREPLY</constant></term>
<listitem>
<para>
Active ou désactive l'ignoration du résultat des commendes de stockage
(set, add, replace, append, prepend, delete, increment, decrement, etc.).
Les commendes de stockage seront envoyé sans passer du temps à attendre
pour une réponse (il n'y aurait pas de réponse).
Les commandes de récupérations tel que <function>Memcached::get</function>
ne sont pas affecté par ce paramètrage.
</para>
<para>Type: &boolean;, par défaut : &false;.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-tcp-nodelay">
<term><constant>Memcached::OPT_TCP_NODELAY</constant></term>
<listitem>
<para>
Active ou non les connexions sans délai des sockets (cela peut être
un gain de performances dans certains environnements.
</para>
<para>
Type : &boolean;, par défaut : &false;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-socket-send-size">
<term><constant>Memcached::OPT_SOCKET_SEND_SIZE</constant></term>
<listitem>
<para>
La taille maximale du buffer d'envoi par socket, en octets.
</para>
<para>
Type : &integer;, par défaut : varie par plate-forme
et configuration du noyau.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-socket-recv-size">
<term><constant>Memcached::OPT_SOCKET_RECV_SIZE</constant></term>
<listitem>
<para>
La taille maximale du buffer de réception par socket, en octets.
</para>
<para>
Type : &integer;, par défaut : varie par plate-forme
et configuration du noyau.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-connect-timeout">
<term><constant>Memcached::OPT_CONNECT_TIMEOUT</constant></term>
<listitem>
<para>
En mode non-bloquant, cette option configure le délai d'expiration
durant la connexion du socket, en millisecondes.
</para>
<para>
Type : &integer;, par défaut : <literal>1000</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-retry-timeout">
<term><constant>Memcached::OPT_RETRY_TIMEOUT</constant></term>
<listitem>
<para>
La durée, en secondes, d'attente avant de tenter à nouveau une
connexion qui a échouée.
</para>
<para>
Type : &integer;, par défaut : <literal>0</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-send-timeout">
<term><constant>Memcached::OPT_SEND_TIMEOUT</constant></term>
<listitem>
<para>
Délai d'expiration d'envoi pour le socket, en microsecondes. Dans les cas
où vous utilisez un socket non bloquant, cela vous permettra d'avoir
des délais d'expiration en envoi de données, malgré tout.
</para>
<para>
Type : &integer;, par défaut : <literal>0</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-recv-timeout">
<term><constant>Memcached::OPT_RECV_TIMEOUT</constant></term>
<listitem>
<para>
Délai d'expiration de réception pour le socket, en microsecondes. Dans les cas
où vous utilisez un socket non bloquant, cela vous permettra d'avoir
des délais d'expiration en réception de données, malgré tout.
</para>
<para>
Type : &integer;, par défaut : <literal>0</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-poll-timeout">
<term><constant>Memcached::OPT_POLL_TIMEOUT</constant></term>
<listitem>
<para>
Délai d'expiration pour le polling de connexions, en millisecondes.
</para>
<para>
Type : &integer;, par défaut : <literal>1000</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-cache-lookups">
<term><constant>Memcached::OPT_CACHE_LOOKUPS</constant></term>
<listitem>
<para>
Active ou non le cache de DNS.
</para>
<para>
Type : &boolean;, par défaut : &false;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.opt-server-failure-limit">
<term><constant>Memcached::OPT_SERVER_FAILURE_LIMIT</constant></term>
<listitem>
<para>
Spécifie la limite du nombre d'échec de connexions. Le serveur sera
alors retiré de la liste après autant d'échec de connexions en succession.
</para>
<para>
Type : &integer;, par défaut : <literal>0</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.have-igbinary">
<term><constant>Memcached::HAVE_IGBINARY</constant></term>
<listitem>
<para>
Indique si le support de la fonction de linéarisation
igbinary est activé.
</para>
<para>Type : &boolean;.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.have-json">
<term><constant>Memcached::HAVE_JSON</constant></term>
<listitem>
<para>
Indique si la fonction de linéarisation JSON
est disponible.
</para>
<para>Type : &boolean;.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.have-msgpack">
<term><constant>Memcached::HAVE_MSGPACK</constant></term>
<listitem>
<para>Indique si le support du sérialiseur msgpack est disponible.</para>
<para>Type : &boolean;.</para>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.have-session">
<term><constant>Memcached::HAVE_SESSION</constant></term>
<listitem>
<para>Type : &boolean;.</para>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.have-sasl">
<term><constant>Memcached::HAVE_SASL</constant></term>
<listitem>
<para>Type : &boolean;.</para>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.get-extended">
<term><constant>Memcached::GET_EXTENDED</constant></term>
<listitem>
<para>
Un drapeau pour <function>Memcached::get</function>,
<function>Memcached::getMulti</function> et
<function>Memcached::getMultiByKey</function> pour s'assurer
que les valeurs du jeton CAS sont également renvoyées.
</para>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.get-preserve-order">
<term><constant>Memcached::GET_PRESERVE_ORDER</constant></term>
<listitem>
<para>Une option pour <function>Memcached::getMulti</function> et
<function>Memcached::getMultiByKey</function> afin de s'assurer que les
clés sont retournées dans le même ordre que leur ordre de requête.
Les clés inexistantes prennent alors la valeur &null;
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-success">
<term><constant>Memcached::RES_SUCCESS</constant></term>
<listitem>
<para>
L'opération a réussi.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-failure">
<term><constant>Memcached::RES_FAILURE</constant></term>
<listitem>
<para>
L'opération a échoué, d'une manière ou d'une autre.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-host-lookup-failure">
<term><constant>Memcached::RES_HOST_LOOKUP_FAILURE</constant></term>
<listitem>
<para>
La recherche DNS a échoué.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-unknown-read-failure">
<term><constant>Memcached::RES_UNKNOWN_READ_FAILURE</constant></term>
<listitem>
<para>
Echec de lecture sur le réseau.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-protocol-error">
<term><constant>Memcached::RES_PROTOCOL_ERROR</constant></term>
<listitem>
<para>
Mauvaise commande dans le protocole memcached.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-client-error">
<term><constant>Memcached::RES_CLIENT_ERROR</constant></term>
<listitem>
<para>
Erreur du coté du client.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-server-error">
<term><constant>Memcached::RES_SERVER_ERROR</constant></term>
<listitem>
<para>
Erreur du coté du serveur.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-write-failure">
<term><constant>Memcached::RES_WRITE_FAILURE</constant></term>
<listitem>
<para>
Echec de l'écriture sur le réseau.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-data-exists">
<term><constant>Memcached::RES_DATA_EXISTS</constant></term>
<listitem>
<para>
Echec de la comparaison et échange : l'élément que vous essayez
de stocker a été modifié depuis votre dernière lecture.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-notstored">
<term><constant>Memcached::RES_NOTSTORED</constant></term>
<listitem>
<para>
L'élément n'a pas été stocké, mais pas à cause d'une erreur. Ceci est
normal, et signifie qu'une condition pour un ajout "<literal>add</literal>"
ou un remplacement "<literal>replace</literal>" n'a pas été satisfait, ou
qu'un élément a été mise dans une queue d'effacement.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-notfound">
<term><constant>Memcached::RES_NOTFOUND</constant></term>
<listitem>
<para>
L'élément avec cette clé n'a pas été trouvé (avec une opération
"<literal>get</literal>" ou "<literal>cas</literal>").
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-partial-read">
<term><constant>Memcached::RES_PARTIAL_READ</constant></term>
<listitem>
<para>
Erreur de lecture partielle sur le réseau.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-some-errors">
<term><constant>Memcached::RES_SOME_ERRORS</constant></term>
<listitem>
<para>
Des erreurs sont survenir durant une lecture multiple.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-no-servers">
<term><constant>Memcached::RES_NO_SERVERS</constant></term>
<listitem>
<para>
Liste de serveurs vide.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-end">
<term><constant>Memcached::RES_END</constant></term>
<listitem>
<para>
Fin de jeu de résultats.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-errno">
<term><constant>Memcached::RES_ERRNO</constant></term>
<listitem>
<para>
Erreur système.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-buffered">
<term><constant>Memcached::RES_BUFFERED</constant></term>
<listitem>
<para>
L'opération a été bufferisée.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-timeout">
<term><constant>Memcached::RES_TIMEOUT</constant></term>
<listitem>
<para>
Le délai d'exécution de l'opération a expiré.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-bad-key-provided">
<term><constant>Memcached::RES_BAD_KEY_PROVIDED</constant></term>
<listitem>
<para>
Mauvaise clé.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-connection-socket-create-failure">
<term><constant>Memcached::RES_CONNECTION_SOCKET_CREATE_FAILURE</constant></term>
<listitem>
<para>Impossible de créer un socket.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-payload-failure">
<term><constant>Memcached::RES_PAYLOAD_FAILURE</constant></term>
<listitem>
<para>
Échec de traitement : impossible de compresser,
décompresser ou linéariser la valeur.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-auth-problem">
<term><constant>Memcached::RES_AUTH_PROBLEM</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-auth-failure">
<term><constant>Memcached::RES_AUTH_FAILURE</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-auth-continue">
<term><constant>Memcached::RES_AUTH_CONTINUE</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-e2big">
<term><constant>Memcached::RES_E2BIG</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-key-too-big">
<term><constant>Memcached::RES_KEY_TOO_BIG</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-server-temporarily-disabled">
<term><constant>Memcached::RES_SERVER_TEMPORARILY_DISABLED</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="memcached.constants.res-server-memory-allocation-failure">
<term><constant>Memcached::RES_SERVER_MEMORY_ALLOCATION_FAILURE</constant></term>
<listitem>
<para>Disponible à partir de Memcached 3.0.0.</para>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->