granicus.if.org Git - apache/blob - docs/manual/socache.xml.fr

   1 <?xml version="1.0" encoding="ISO-8859-1" ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
   4
   5 <!-- English Revision : 1305167 -->
   6 <!-- French translation : Lucien GENTIS -->
   7 <!-- Reviewed by : Vincent Deffontaines -->
   8
   9 <!--
  10  Licensed to the Apache Software Foundation (ASF) under one or more
  11  contributor license agreements.  See the NOTICE file distributed with
  12  this work for additional information regarding copyright ownership.
  13  The ASF licenses this file to You under the Apache License, Version 2.0
  14  (the "License"); you may not use this file except in compliance with
  15  the License.  You may obtain a copy of the License at
  16
  17      http://www.apache.org/licenses/LICENSE-2.0
  18
  19  Unless required by applicable law or agreed to in writing, software
  20  distributed under the License is distributed on an "AS IS" BASIS,
  21  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  22  See the License for the specific language governing permissions and
  23  limitations under the License.
  24 -->
  25
  26 <manualpage metafile="socache.xml.meta">
  27
  28   <title>Le cache des objets partag&eacute;s du serveur HTTP Apache</title>
  29
  30   <summary>
  31     <p>Le cache des objets partag&eacute;s est un concept de partage de donn&eacute;es
  32     de base entre tous les processus d'un serveur, sans se pr&eacute;occuper du
  33     <a href="mpm.html">mod&egrave;le de threads et de processus</a>. On
  34     l'utilise lorsque les avantages apport&eacute;s par le partage de donn&eacute;es
  35     entre processus contrebalance la perte de performances cons&eacute;cutive &agrave;
  36     la communication interprocessus.</p>
  37   </summary>
  38
  39   <section id="providers">
  40     <title>Fournisseurs du cache d'objets partag&eacute;s</title>
  41     <p>Le cache d'objets partag&eacute;s en tant que tel est une abstraction.
  42     Il est impl&eacute;ment&eacute; par quatre modules diff&eacute;rents. Pour pouvoir
  43     utiliser le cache, un ou plusieurs de ces modules doivent &ecirc;tre
  44     pr&eacute;sents et configur&eacute;s.</p>
  45     <p>Le seul &eacute;l&eacute;ment de configuration consiste &agrave; d&eacute;finir le
  46     fournisseur de cache &agrave; utiliser. Ceci est de la responsabilit&eacute; des
  47     modules qui utilisent le cache, et pour cela, ils activent la
  48     s&eacute;lection via des directives telles que <directive
  49     module="mod_cache_socache">CacheSocache</directive>, <directive
  50     module="mod_authn_socache">AuthnCacheSOCache</directive>, <directive
  51     module="mod_ssl">SSLSessionCache</directive>, et <directive
  52     module="mod_ssl">SSLStaplingCache</directive>.</p>
  53     <p>Les fournisseurs actuellement disponibles sont :</p>
  54     <dl>
  55     <dt>"dbm" (<module>mod_socache_dbm</module>)</dt>
  56     <dd>Celui-ci utilise un fichier de hashage DBM. Le choix de la
  57     DBM sous-jacente peut &ecirc;tre configurable si la version
  58     d'APR install&eacute;e supporte de multiples impl&eacute;mentations de DBM.</dd>
  59     <dt>"dc" (<module>mod_socache_dc</module>)</dt>
  60     <dd>Celui-ci utilise les biblioth&egrave;ques de mise en cache de sessions
  61     distribu&eacute;es <a href="http://www.distcache.org/">distcache</a>.</dd>
  62     <dt>"memcache" (<module>mod_socache_memcache</module>)</dt>
  63     <dd>Celui-ci utilise le syst&egrave;me &agrave; hautes performances de mise en
  64     cache d'objets de m&eacute;moire distribu&eacute;e <a
  65     href="http://memcached.org/">memcached</a>.</dd>
  66     <dt>"shmcb" (<module>mod_socache_shmcb</module>)</dt>
  67     <dd>Celui-ci utilise un tampon cyclique &agrave; hautes performances au
  68     sein d'un segment de m&eacute;moire partag&eacute;e.</dd>
  69     </dl>
  70
  71     <p>L'API fournit les fonctions suivantes :</p>
  72
  73     <dl>
  74       <dt>const char *create(ap_socache_instance_t **instance, const char *arg,
  75                           apr_pool_t *tmp, apr_pool_t *p);</dt>
  76       <dd>Cette fonction permet de cr&eacute;er un cache de session bas&eacute; sur
  77       la cha&icirc;ne de configuration sp&eacute;cifi&eacute;e. Le pointeur d'instance
  78       renvoy&eacute; dans le param&egrave;tre instance sera pass&eacute; comme premier
  79       argument des invocations subs&eacute;quentes.</dd>
  80
  81       <dt>apr_status_t init(ap_socache_instance_t *instance, const char *cname,
  82                          const struct ap_socache_hints *hints,
  83                          server_rec *s, apr_pool_t *pool)</dt>
  84       <dd>Cette fonction permet d'initialiser le cache. L'argument cname
  85       doit avoir une longueur maximale de 16 caract&egrave;res et permet
  86       d'identifier de mani&egrave;re unique l'utilisateur du cache au sein du
  87       serveur ; il est recommand&eacute; d'utiliser le nom du module, par
  88       exemple "mod_ssl-sess". Comme cette cha&icirc;ne peut &ecirc;tre utilis&eacute;e au
  89       sein d'un syst&egrave;me de fichiers, il est conseill&eacute; de n'utiliser que
  90       des caract&egrave;res alphanum&eacute;riques [a-z0-9_-]. Si l'argument hints
  91       n'est pas &eacute;gal &agrave; NULL, il fournit un ensemble d'indications au
  92       fournisseur. La valeur retourn&eacute;e est le code d'erreur APR.</dd>
  93
  94       <dt>void destroy(ap_socache_instance_t *instance, server_rec *s)</dt>
  95       <dd>Cette fonction permet de d&eacute;truire l'instance de cache
  96       sp&eacute;cifi&eacute;e.</dd>
  97
  98       <dt>apr_status_t store(ap_socache_instance_t *instance, server_rec *s,
  99                           const unsigned char *id, unsigned int idlen,
 100                           apr_time_t expiry,
 101                           unsigned char *data, unsigned int datalen,
 102                           apr_pool_t *pool)</dt>
 103       <dd>Cette fonction permet de stocker un objet dans une instance de
 104       cache.</dd>
 105
 106       <dt>apr_status_t retrieve(ap_socache_instance_t *instance, server_rec *s,
 107                              const unsigned char *id, unsigned int idlen,
 108                              unsigned char *data, unsigned int *datalen,
 109                              apr_pool_t *pool)</dt>
 110       <dd>Cette fonction permet d'extraire un objet du cache.</dd>
 111
 112       <dt>apr_status_t remove(ap_socache_instance_t *instance, server_rec *s,
 113                            const unsigned char *id, unsigned int idlen,
 114                            apr_pool_t *pool)</dt>
 115       <dd>Supprime un objet du cache.</dd>
 116
 117       <dt>void status(ap_socache_instance_t *instance, request_rec *r, int flags)</dt>
 118       <dd>Descend le d&eacute;tail d'une instance de cache &agrave; destination de mod_status.</dd>
 119
 120       <dt>apr_status_t iterate(ap_socache_instance_t *instance, server_rec *s,
 121                             void *userctx, ap_socache_iterator_t *iterator,
 122                             apr_pool_t *pool)</dt>
 123       <dd>Descend tous les objets en cache &agrave; destination d'une fonction <code>iterator callback</code>.</dd>
 124     </dl>
 125
 126   </section>
 127
 128 </manualpage>