From: Takashi Sato Date: Thu, 6 Nov 2008 23:10:56 +0000 (+0000) Subject: update transformations X-Git-Tag: 2.3.0~132 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b24562780490cd24739fa061a4f1e9f1fd7e603e;p=thirdparty%2Fapache%2Fhttpd.git update transformations git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@712006 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/caching.html.en b/docs/manual/caching.html.en index c91855f2632..94466d70b7f 100644 --- a/docs/manual/caching.html.en +++ b/docs/manual/caching.html.en @@ -24,8 +24,7 @@

This document supplements the mod_cache, - mod_disk_cache, mod_mem_cache, - mod_file_cache and htcacheclean reference documentation. + mod_disk_cache, mod_file_cache and htcacheclean reference documentation. It describes how to use Apache's caching features to accelerate web and proxy serving, while avoiding common problems and misconfigurations.

@@ -48,7 +47,7 @@ handling, both as an origin webserver and as a proxy.

mod_cache and its provider modules - mod_mem_cache and mod_disk_cache + mod_disk_cache provide intelligent, HTTP-aware caching. The content itself is stored in the cache, and mod_cache aims to honour all of the various HTTP headers and options that control the cachability of content. It can @@ -83,7 +82,7 @@ -
Related ModulesRelated Directives
+
Related ModulesRelated Directives

There are two main stages in mod_cache that can occur in the lifetime of a request. First, mod_cache @@ -198,7 +197,7 @@ changed in size or modification time. As such, even if Apache is caching local content, even expired content may still be served faster from the cache if it has not changed. As long as reading from the cache - store is faster than reading from the backend (e.g. an in-memory cache + store is faster than reading from the backend (e.g. mod_disk_cache with memory disk compared to reading from disk).

@@ -373,12 +372,12 @@ Vary: negotiate,accept-language,accept-charset

File-Handle Caching

-
Related ModulesRelated Directives
+
Related ModulesRelated Directives

The act of opening a file can itself be a source of delay, particularly on network filesystems. By maintaining a cache of open file descriptors for commonly served files, Apache can avoid this delay. Currently Apache - provides two different implementations of File-Handle Caching.

+ provides one implementation of File-Handle Caching.

CacheFile

@@ -415,25 +414,12 @@ Vary: negotiate,accept-language,accept-charset descriptor closed.

-

CacheEnable fd

- - -

mod_mem_cache also provides its own file-handle - caching scheme, which can be enabled via the - CacheEnable directive.

- - 
CacheEnable fd /
- -

As with all of mod_cache this type of file-handle - caching is intelligent, and handles will not be maintained beyond - the expiry time of the cached content.

-
top

In-Memory Caching

-
Related ModulesRelated Directives
+
Related ModulesRelated Directives

Serving directly from system memory is universally the fastest method of serving content. Reading files from a disk controller or, even worse, @@ -490,11 +476,6 @@ sys 0m0.000s

caching there are some circumstances in which in-memory caching may be better performed by Apache.

-

Firstly, an operating system can only cache files it knows about. If - you are running Apache as a proxy server, the files you are caching are - not locally stored but remotely served. If you still want the unbeatable - speed of in-memory caching, Apache's own memory caching is needed.

-

MMapStatic Caching

@@ -518,24 +499,6 @@ sys 0m0.000s to ensure that the files mapped are not so large as to cause the system to swap memory.

- -

mod_mem_cache Caching

- - -

mod_mem_cache provides a HTTP-aware intelligent - in-memory cache. It also uses heap memory directly, which means that - even if MMap is not supported on your system, - mod_mem_cache may still be able to perform caching.

- -

Caching of this type is enabled via;

- - 
-# Enable memory caching
-CacheEnable mem /
-
-# Limit the size of the cache to 1 Megabyte
-MCacheSize 1024
-
top

Disk-based Caching

@@ -544,9 +507,8 @@ MCacheSize 1024
Related ModulesRelated Directives

mod_disk_cache provides a disk-based caching mechanism - for mod_cache. As with mod_mem_cache - this cache is intelligent and content will be served from the cache only - as long as it is considered valid.

+ for mod_cache. This cache is intelligent and content will + be served from the cache only as long as it is considered valid.

Typically the module will be configured as so;

diff --git a/docs/manual/caching.html.fr b/docs/manual/caching.html.fr index a624c59fcef..d132a16cef6 100644 --- a/docs/manual/caching.html.fr +++ b/docs/manual/caching.html.fr @@ -24,8 +24,7 @@

Ce document complète la documentation de référence des modules - mod_cache, - mod_disk_cache, mod_mem_cache, + mod_cache, mod_disk_cache, mod_file_cache et du programme htcacheclean. Il décrit l'utilisation des fonctionnalités de mise en cache d'Apache pour accélérer les services web et proxy, tout en évitant les problèmes @@ -51,8 +50,8 @@ d'accélération de la gestion HTTP, tant comme serveur web originel que comme mandataire.

-

Le module mod_cache et ses modules de soutien - mod_mem_cache et mod_disk_cache +

Le module mod_cache et son module de soutien + mod_disk_cache permettent une mise en cache intelligente du point de vue HTTP. Le contenu proprement dit est stocké dans le cache, et mod_cache tente d'honorer tous les en-têtes HTTP et les options @@ -94,7 +93,7 @@ -
Modules ApparentésDirectives Apparentées
+
Modules ApparentésDirectives Apparentées

mod_cache peut faire intervenir deux phases principales pendant la durée de vie d'une requête. @@ -225,7 +224,7 @@ depuis le cache s'il n'a pas été modifié, parce que la lecture depuis le cache est plus rapide que la lecture depuis le processus en arrière-plan (à comparer à la différence de vitesse entre la lecture depuis un cache en - mémoire et la lecture depuis un disque).

+ mémoire avec mod_disk_cache et la lecture depuis un disque).

Que peut-on mettre en cache ?

@@ -421,14 +420,14 @@ Vary: negotiate,accept-language,accept-charset

Mise en cache de la gestion de fichier

-
Modules ApparentésDirectives Apparentées
+
Modules ApparentésDirectives Apparentées

Le fait d'ouvrir un fichier peut en lui-même introduire un délai, en particulier dans les systèmes de fichiers répartis sur le réseau. Apache peut s'affranchir de ce délai en maintenant un cache des descripteurs de fichiers ouverts pour ce qui concerne les fichiers souvent accédés. Apache propose - actuellement deux implémentations différentes de mise en cache de la + actuellement une implémentation de mise en cache de la gestion de fichier.

Directive CacheFile

@@ -472,27 +471,13 @@ Vary: negotiate,accept-language,accept-charset descripteur de fichier sera fermé.

-

Directive CacheEnable

- - -

Le module mod_mem_cache propose aussi son propre - schéma de mise en cache de la gestion de fichier, qui peut être activé - à l'aide de la directive - CacheEnable.

- - 
CacheEnable fd /
- -

A l'instar de tout ce qui concerne le module - mod_cache, ce mode de mise en cache de la gestion de - fichier est intelligent, et les descripteurs ne seront plus maintenus - lorsque le contenu mis en cache sera arrivé à expiration.

top

Mise en cache en mémoire

-
Modules ApparentésDirectives Apparentées
+
Modules ApparentésDirectives Apparentées

Servir un contenu directement depuis la mémoire système est universellement reconnu comme la méthode la plus rapide. Lire des fichiers @@ -557,13 +542,6 @@ sys 0m0.000s

peut être effectuée plus efficacement par Apache dans certaines circonstances.

-

En premier lieu, un système d'exploitation ne peut mettre en cache que - les fichiers dont il a connaissance. Si vous exécutez Apache en tant que - serveur mandataire, les fichiers que vous mettez en cache ne sont pas - stockés en local mais sur un serveur distant. Si vous voulez tout de même - bénéficier de la vitesse incomparable procurée par la mise en cache en - mémoire, la mise en cache propre à Apache sera nécessaire.

-

Mise en cache à l'aide de la directive MMapStatic

@@ -590,24 +568,6 @@ sys 0m0.000s trop importante afin d'épargner au système l'utilisation du swap.

-

Mise en cache à l'aide du module mod_mem_cache

- - -

Le module mod_mem_cache propose une mise en cache en - mémoire intelligente du point de vue du protocole HTTP. Il utilise aussi - directement le "tas" de la mémoire, ce qui signifie que même si - MMap n'est pas supporté par votre système, - mod_mem_cache pourra quand-même effectuer - la mise en cache.

- -

La mise en cache selon cette méthode est activée comme suit :

- - 
-# Activation de la mise en cache en mémoire
-CacheEnable mem /
-
-# Limite la taille du cache à 1 Mégaoctet
-MCacheSize 1024
top
@@ -617,8 +577,7 @@ MCacheSize 1024
Modules ApparentésDirectives Apparentées

Le module mod_disk_cache fournit un mécanisme de mise - en cache sur disque au module mod_cache. Comme dans le cas - du module mod_mem_cache, cette mise en cache est + en cache sur disque au module mod_cache. Cette mise en cache est intelligente et le contenu ne sera servi qu'à partir du cache tant qu'il sera considéré comme valide.

diff --git a/docs/manual/caching.html.tr.utf8 b/docs/manual/caching.html.tr.utf8 index 8eb56215e08..92a6db76ef8 100644 --- a/docs/manual/caching.html.tr.utf8 +++ b/docs/manual/caching.html.tr.utf8 @@ -22,6 +22,7 @@  fr  |  tr 

+
Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.

Bu belge mod_cache, mod_disk_cache, mod_mem_cache, diff --git a/docs/manual/caching.xml.meta b/docs/manual/caching.xml.meta index d639933311d..ec2d32f28a0 100644 --- a/docs/manual/caching.xml.meta +++ b/docs/manual/caching.xml.meta @@ -9,6 +9,6 @@ en fr - tr + tr diff --git a/docs/manual/caching.xml.tr b/docs/manual/caching.xml.tr index 2abe0fac5f7..b1172e6252a 100644 --- a/docs/manual/caching.xml.tr +++ b/docs/manual/caching.xml.tr @@ -1,7 +1,7 @@ - + + + + + + + + + + + +