From: Lucien Gentis Tout fichier pris en compte par le gestionnaire
- Comme introduction à l'utilisation des scripts CGI avec Apache,
+ Comme introduction à l'utilisation des scripts CGI avec Apache,
voir notre tutoriel Les contenus
dynamiques avec CGI. Il est recommandé d'utiliser le module Il est recommandé d'utiliser le module À des fins de compatibilité ascendante, le gestionnaire
- cgi-script sera aussi activé pour tout fichier possédant le type
+ à des fins de compatibilité ascendante, le gestionnaire
+ cgi-script sera aussi activé pour tout fichier possédant le type
MIME cgi-script
sera traité en tant que script CGI et
- exécuté par le serveur, sa sortie étant renvoyée au client. Les
- fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent
- un nom contenant une extension définie par la directive application/x-httpd-cgi
. L'utilisation du type
- MIME magic est obsolète.
Le serveur va définir les variables d'environnement CGI comme - décrit dans la Spécification CGI, de la - manière suivante :
+Le serveur va définir les variables d'environnement CGI comme + décrit dans la Spécification CGI, de la + manière suivante :
off
. Par défaut, si la
- directive off
. Par défaut, si la
+ directive On
.On
.
on
(elle est à off
par défaut), et si
- une recherche DNS inverse sur l'adresse IP de l'hôte client
- aboutit effectivement à un nom d'hôte.on
(elle est à off
par défaut), et si
+ une recherche DNS inverse sur l'adresse IP de l'hôte client
+ aboutit effectivement à un nom d'hôte.on
, et si l'hôte client supporte le
+ est définie à on
, et si l'hôte client supporte le
protocole ident. Notez que l'on ne peut accorder une confiance
- aveugle au contenu de cette variable car il peut être aisément
- falsifié, et si un mandataire s'intercale entre le client et le
+ aveugle au contenu de cette variable car il peut être aisément
+ falsifié, et si un mandataire s'intercale entre le client et le
serveur, il est totalement inutilisable.Ce module utilise aussi les fonctions de base ap_add_common_vars + et ap_add_cgi_vars + pour ajouter des variables d'environnement comme :
+Pour une liste exhaustive de ces variables, vous pouvez écrire un script + CGI basique qui extrait toutes les variables d'environnement passées par + Apache selon un format adapté. +
Le débogage des scripts CGI était difficile par le passé,
- principalement parce qu'il n'était pas possible d'étudier la sortie
- (sortie standard et erreurs) des scripts dont l'exécution échouait.
- Les directives qui suivent permettent une journalisation plus détaillée des
+ Le débogage des scripts CGI était difficile par le passé,
+ principalement parce qu'il n'était pas possible d'étudier la sortie
+ (sortie standard et erreurs) des scripts dont l'exécution échouait.
+ Les directives qui suivent permettent une journalisation plus détaillée des
erreurs. Lorsqu'il est configuré, le journal des erreurs CGI enregistre
- la sortie de tout programme CGI dont l'exécution ne s'effectue pas
- correctement. Un script CGI dont l'exécution échoue provoque la
- journalisation d'une grande quantité d'informations. Les deux
- premières lignes possèdent toujours le format suivant : Lorsqu'il est configuré, le journal des erreurs CGI enregistre
+ la sortie de tout programme CGI dont l'exécution ne s'effectue pas
+ correctement. Un script CGI dont l'exécution échoue provoque la
+ journalisation d'une grande quantité d'informations. Les deux
+ premières lignes possèdent toujours le format suivant : Si le script CGI n'a pas pu démarrer, le fichier journal
- contiendra les deux lignes supplémentaires suivantes : Si le script CGI n'a pas pu démarrer, le fichier journal
+ contiendra les deux lignes supplémentaires suivantes :
- %% état HTTP nom du script CGI
+ %% [date] requête
+ %% état HTTP nom du script CGI
@@ -138,16 +167,16 @@ CGI
Par contre, si l'erreur provient du renvoi par le script - d'informations incorrectes dans les en-têtes (dû souvent à une - bogue du script), les informations suivantes sont journalisées + d'informations incorrectes dans les en-têtes (dû souvent à une + bogue du script), les informations suivantes sont journalisées :
(Les parties %stdout et %stderr seront absentes si le script - n'a rien envoyé sur la sortie standard ou la sortie + n'a rien envoyé sur la sortie standard ou la sortie d'erreurs).
@@ -171,13 +200,13 @@ CGILa directive
La directive
Ce journal sera ouvert par l'utilisateur sous lequel les
- processus enfants s'exécutent, c'est à dire l'utilisateur spécifié
+ processus enfants s'exécutent, c'est à dire l'utilisateur spécifié
par la directive du serveur
Notez que l'on ne doit activer la journalisation des scripts - qu'à des fins de débogage lors de l'écriture de scripts CGI, et non - de manière permanente sur un serveur en production. Elle n'est pas - optimisée en terme de performances et d'efficacité, et peut - présenter des problèmes de sécurité si on l'utilise dans un cadre - autre que celui pour lequel elle a été conçue.
+ qu'à des fins de débogage lors de l'écriture de scripts CGI, et non + de manière permanente sur un serveur en production. Elle n'est pas + optimisée en terme de performances et d'efficacité, et peut + présenter des problèmes de sécurité si on l'utilise dans un cadre + autre que celui pour lequel elle a été conçue.La directive
Cette directive permet de limiter la taille du corps de toute - entité PUT ou POST qui sera enregistrée dans le journal, afin - de prévenir une croissance trop importante et trop rapide du fichier - journal due à la réception de corps de requête de grandes tailles. + entité PUT ou POST qui sera enregistrée dans le journal, afin + de prévenir une croissance trop importante et trop rapide du fichier + journal due à la réception de corps de requête de grandes tailles. Cette directive permet de modifier cette taille maximale, dont la - valeur par défaut est de 1024 octets.
+ valeur par défaut est de 1024 octets.Le module
Le module DEFLATE
qui permet de comprimer la sortie de
- votre serveur avant de l'envoyer au client sur le réseau.
Le seul codage supporté est Le seul codage supporté est gzip
afin d'assurer une complète
- compatibilité avec les anciens navigateurs. Le codage deflate
- n'est donc pas supporté ; voir à ce sujet la gzip
afin d'assurer une complète
+ compatibilité avec les anciens navigateurs. Le codage deflate
+ n'est donc pas supporté ; voir à ce sujet la documentation de zlib
- pour une explication détaillée.
+ pour une explication détaillée.
Certaines applications web sont vulnérables aux attaques +
Certaines applications web sont vulnérables aux attaques visant le vol d'information lorsqu'une connexion TLS transmet - des données compressées par deflate. Pour plus de détails, - étudiez les attaques de la famille "BREACH".
+ des données compressées par deflate. Pour plus de détails, + étudiez les attaques de la famille "BREACH".Voici une configuration simple qui comprime les contenus à base +
Voici une configuration simple qui comprime les contenus à base de texte courants.
Certaines applications web sont vulnérables aux attaques pour - vol d'information lorsque la connexion TLS transmet des données - compressées par deflate. Pour plus d'informations, voir en - détails la famille d'attaques de type "BREACH".
+Certaines applications web sont vulnérables aux attaques pour + vol d'information lorsque la connexion TLS transmet des données + compressées par deflate. Pour plus d'informations, voir en + détails la famille d'attaques de type "BREACH".
La compression est implémentée par le La compression est implémentée par le filtre DEFLATE
. La
directive suivante active la compression des documents dans le
- conteneur où elle est placée :
Si vous voulez limiter la compression à certains types MIME +
Si vous voulez limiter la compression à certains types MIME
particuliers, vous pouvez utiliser la directive
DEFLATE
est toujours inséré après les
+ Le filtre DEFLATE
est toujours inséré après les
filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les
- sous-requêtes internes.
+ sous-requêtes internes.
force-gzip
, définie à
+ La variable d'environnement force-gzip
, définie Ã
l'aide de la directive Le module INFLATE
dans la chaîne de filtrage en sortie via la
+ permettant de décomprimer un corps de réponse comprimé par gzip.
+ Pour activer cette fonctionnalité, vous devez insérer le filtre
+ INFLATE
dans la chaîne de filtrage en sortie via la
directive
Dans cet exemple, les sorties comprimées par gzip en - provenance de example.com seront décomprimées afin de pouvoir - être éventuellement traitées par d'autres filtres. +
Dans cet exemple, les sorties comprimées par gzip en + provenance de example.com seront décomprimées afin de pouvoir + être éventuellement traitées par d'autres filtres.
Le module Le module Désormais, si une requête contient un en-tête
+ Désormais, si une requête contient un en-tête
Si vous évaluez vous-même la taille du corps de requête,
- ne faites pas confiance à l'en-tête
- Si vous évaluez vous-même la taille du corps de requête,
+ ne faites pas confiance à l'en-tête
+ DEFLATE
dans la chaîne de filtrage en entrée via la
+ DEFLATE
dans la chaîne de filtrage en entrée via la
directive Content-Encoding: gzip
, son corps sera
- automatiquement décomprimé. Peu de navigateurs sont actuellement
- en mesure de comprimer les corps de requêtes. Cependant,
- certaines applications spécialisées supportent les requêtes
- comprimées, comme par exemple certains clients WebDAV.Content-Length
Content-Length
! L'en-tête
- Content-Length indique la longueur des données en provenance du
- client, et non la quantité d'octets que représente le
- flux de données décompressé.Content-Length
! L'en-tête
+ Content-Length indique la longueur des données en provenance du
+ client, et non la quantité d'octets que représente le
+ flux de données décompressé.
Le module Vary: Accept-Encoding
pour avertir les
- mandataires qu'une réponse enregistrée dans le cache ne doit être
- envoyée qu'aux clients qui ont envoyé l'en-tête de requête
- Accept-Encoding
approprié. Ceci permet d'éviter l'envoi
- d'un contenu comprimé à un client qui ne sera pas en mesure
- de l'interpréter.
Si vous avez défini des exclusions spécifiques dépendant, par
- exemple, de l'en-tête User-Agent
, vous devez
- ajouter manuellement des données à l'en-tête Vary
afin
- d'informer les mandataires des restrictions supplémentaires. Par
- exemple, dans la configuration classique où l'addition du filtre
- DEFLATE
dépend du contenu de l'en-tête
- User-Agent
, vous devez spécifier :
Le module Vary: Accept-Encoding
pour avertir les
+ mandataires qu'une réponse enregistrée dans le cache ne doit être
+ envoyée qu'aux clients qui ont envoyé l'en-tête de requête
+ Accept-Encoding
approprié. Ceci permet d'éviter l'envoi
+ d'un contenu comprimé à un client qui ne sera pas en mesure
+ de l'interpréter.
Si vous avez défini des exclusions spécifiques dépendant, par
+ exemple, de l'en-tête User-Agent
, vous devez
+ ajouter manuellement des données à l'en-tête Vary
afin
+ d'informer les mandataires des restrictions supplémentaires. Par
+ exemple, dans la configuration classique où l'addition du filtre
+ DEFLATE
dépend du contenu de l'en-tête
+ User-Agent
, vous devez spécifier :
Si votre décision de comprimer le contenu dépend d'autres
- informations que celles contenues dans les en-têtes de la requête
- (par exemple la version HTTP), vous devez attribuer à l'en-tête
- Vary
la valeur *
, ce qui permet d'empêcher
+
Si votre décision de comprimer le contenu dépend d'autres
+ informations que celles contenues dans les en-têtes de la requête
+ (par exemple la version HTTP), vous devez attribuer à l'en-tête
+ Vary
la valeur *
, ce qui permet d'empêcher
les mandataires compatibles de tout mettre en cache.
Comme
Comme
La directive
Pour extraire des informations plus précises de vos journaux, - vous pouvez utiliser l'argument type pour spécifier le - type de données de la note enregistrée dans le journal. +
Pour extraire des informations plus précises de vos journaux, + vous pouvez utiliser l'argument type pour spécifier le + type de données de la note enregistrée dans le journal. type peut prendre une des valeurs suivantes :
Input
Output
Ratio
sortie/entrée *
- 100
) dans la note. Il s'agit de la valeur par défaut si
+ sortie/entrée *
+ 100
) dans la note. Il s'agit de la valeur par défaut si
l'argument type est omis.Vous pouvez donc configurer votre journalisation de la manière +
Vous pouvez donc configurer votre journalisation de la manière suivante :
-La directive
Transfer-Encoding
prend la valeur
+ Chunked
), ceci ayant comme effet de bord de ne définir aucun
+ en-tête HTTP Content-Length
. Il est important de connaître ce
+ comportement, particulièrement lorsque httpd travaille derrière des
+ mandataires inverses avec mise en cache, ou lorsque httpd est configuré pour
+ utiliser Content-Length
peuvent ne pas
+ être mises en cache.
La directive
La directive
La directive
La valeur doit être comprise entre 1 (compression minimale) et 9 +
La valeur doit être comprise entre 1 (compression minimale) et 9 (compression maximale).
La directive
La directive
La directive
Le module
httpd.conf
ou dans un fichier
- .htaccess
. Le chemin généré par une règle de
- réécriture peut inclure une chaîne de paramètres, ou peut renvoyer
+ d'en-têtes HTTP, ou de repères temporels.
httpd.conf
ou dans un fichier
+ .htaccess
. Le chemin généré par une règle de
+ réécriture peut inclure une chaîne de paramètres, ou peut renvoyer
vers un traitement secondaire interne, une redirection vers une
- requête externe ou vers le mandataire interne.
Vous trouverez d'avantage de détails, discussions et exemples +
Vous trouverez d'avantage de détails, discussions et exemples dans la - documentation détaillée + documentation détaillée sur mod_rewrite.
trace1
à
- trace8
. Le niveau de journalisation peut être défini de
- manière spécifique à
trace1
Ã
+ trace8
. Le niveau de journalisation peut être défini de
+ manière spécifique à debug
aucune action n'est journalisée, alors qu'elles
+ debug
aucune action n'est journalisée, alors qu'elles
le sont pratiquement toutes au niveau trace8
.
trace2
qu'à des fins de débogage !
+ de manière dramatique ! N'utilisez un niveau de journalisation
+ supérieur à trace2
qu'à des fins de débogage !
Ceux qui sont familiers avec les versions précédentes de +
Ceux qui sont familiers avec les versions précédentes de
RewriteLog
et
- RewriteLogLevel
. Elles ont été en effet remplacées
+ RewriteLogLevel
. Elles ont été en effet remplacées
par une configuration de la journalisation par module, comme
- mentionné plus haut.
+ mentionné plus haut.
Pour extraire les traces spécifiques à +
Pour extraire les traces spécifiques Ã
La directive off
, ce module n'exécutera aucun traitement et ne
- mettra pas à jour les variables d'environnement
+ désactive l'exécution du moteur de réécriture. Si sa valeur est
+ off
, ce module n'exécutera aucun traitement et ne
+ mettra pas à jour les variables d'environnement
SCRIPT_URx
.
Plutôt que de commenter toutes les directives
Plutôt que de commenter toutes les directives
Notez que les hôtes virtuels n'héritent pas des
- configurations de réécriture. Ceci implique que vous devez
- insérer une directive RewriteEngine on
dans chaque
- hôte virtuel pour lequel vous souhaitez utiliser des règles
- de réécriture.
Notez que les hôtes virtuels n'héritent pas des
+ configurations de réécriture. Ceci implique que vous devez
+ insérer une directive RewriteEngine on
dans chaque
+ hôte virtuel pour lequel vous souhaitez utiliser des règles
+ de réécriture.
Les directives prg
ne sont pas prises en compte au cours de
- l'initialisation du serveur si elle ont été définies dans un
- contexte où la directive on
.
on
.
MaxRedirects
n'est plus disponible depuis
-la version version 2.1La directive
La directive
Inherit
Ceci force la configuration locale à hériter de la - configuration du niveau supérieur. Dans le contexte des hôtes +
Ceci force la configuration locale à hériter de la
+ configuration du niveau supérieur. Dans le contexte des hôtes
virtuels, cela signifie que les correspondances, conditions et
- règles du serveur principal sont héritées. Dans le contexte des
- répertoires, cela signifie que les conditions et règles de la
+ règles du serveur principal sont héritées. Dans le contexte des
+ répertoires, cela signifie que les conditions et règles de la
configuration .htaccess
ou les sections
InheritBefore
Même effet que l'option Inherit
ci-dessus, mais
- les règles spécifiées dans le niveau parent s'appliquent
- avant les règles spécifiées dans le niveau
+
Même effet que l'option Inherit
ci-dessus, mais
+ les règles spécifiées dans le niveau parent s'appliquent
+ avant les règles spécifiées dans le niveau
enfant.
Disponible depuis la version 2.3.10 du serveur HTTP
Apache.
InheritDown
Si cette option est activée, toutes les configurations enfants
- hériteront de la configuration courante. Il en est de même si l'on
- spécifie RewriteOptions Inherit
dans toutes les
+
Si cette option est activée, toutes les configurations enfants
+ hériteront de la configuration courante. Il en est de même si l'on
+ spécifie RewriteOptions Inherit
dans toutes les
configurations enfants. Voir l'option Inherit
pour
- plus de détails à propos de la manière dont les relations
- parent-enfants sont traitées.
- Cette option est disponible à partir
+ plus de détails à propos de la manière dont les relations
+ parent-enfants sont traitées.
+ Cette option est disponible à partir
de la version 2.4.8 du serveur HTTP Apache.
InheritDownBefore
L'effet de cette option est équivalent à celui de l'option
- InheritDown
ci-dessus, mais les règles de la
+
L'effet de cette option est équivalent à celui de l'option
+ InheritDown
ci-dessus, mais les règles de la
configuration parente s'appliquent avant toute
- règle de la configuration enfant.
- Cette option est disponible à partir
+ règle de la configuration enfant.
+ Cette option est disponible à partir
de la version 2.4.8 du serveur HTTP Apache.
IgnoreInherit
Si cette option est activée, les configurations courante et - enfants ignoreront toute règle héritée d'une configuration parente +
Si cette option est activée, les configurations courante et
+ enfants ignoreront toute règle héritée d'une configuration parente
via les options InheritDown
ou
InheritDownBefore
.
- Cette option est disponible à partir
+ Cette option est disponible à partir
de la version 2.4.8 du serveur HTTP Apache.
AllowNoSlash
Par défaut,
Par défaut,
Lorsque la directive AllowNoSlash
pour
- s'assurer que les règles de réécriture ne soient plus ignorées.
+ module="mod_dir">DirectorySlash est définie à off, il
+ est possible de spécifier l'option AllowNoSlash
pour
+ s'assurer que les règles de réécriture ne soient plus ignorées.
Si on le souhaite, cette option permet de faire s'appliquer des
- règles de réécriture qui correspondent à un répertoire sans slash
+ règles de réécriture qui correspondent à un répertoire sans slash
final au sein de fichiers .htaccess.
- Elle est disponible à
+ Elle est disponible Ã
partir de la version 2.4.0 du serveur HTTP Apache.
A partir de la version 2.2.22 de httpd, lorsqu'une directive serveur virtuel
ou de serveur principal,
- AllowAnyURI
, afin de permettre à
-
+ Pour s'affranchir de la restriction relative à la syntaxe des chemins URL, on peut
+ utiliser l'option AllowAnyURI
, afin de permettre Ã
+
Disponible depuis la version 2.4.3 du serveur HTTP Apache.
L'utilisation de cette option rendra le serveur vulnérable à
- certains problèmes de sécurité si les règles de réécritures
- concernées n'ont pas été rédigées avec soin. Il est par conséquent
- fortement recommandé de ne pas utiliser cette
- option. En particulier, prêtez attention aux chaînes en entrée contenant le
- caractère '@
', qui peuvent modifier l'interprétation
- de l'URI réécrite, comme indiqué dans les liens ci-dessus.
L'utilisation de cette option rendra le serveur vulnérable Ã
+ certains problèmes de sécurité si les règles de réécritures
+ concernées n'ont pas été rédigées avec soin. Il est par conséquent
+ fortement recommandé de ne pas utiliser cette
+ option. En particulier, prêtez attention aux chaînes en entrée contenant le
+ caractère '@
', qui peuvent modifier l'interprétation
+ de l'URI réécrite, comme indiqué dans les liens ci-dessus.
MergeBase
Avec cette option, la valeur de la directive
IgnoreContextInfo
Dans les versions 2.4.13 et antérieures, lors d'une - substitution relative dans un contexte de répertoire (htaccess), +
Lors d'une substitution relative dans un contexte de répertoire (htaccess),
et si la directive
La directive
La directive
MapName est le nom de la table de correspondance - et servira à spécifier une fonction de mise en correspondance - pour les chaînes de substitution d'une règle de réécriture selon + et servira à spécifier une fonction de mise en correspondance + pour les chaînes de substitution d'une règle de réécriture selon une des constructions suivantes :
- ${
nom_de_la_correspondance :
- mot-clé }
- ${
nom_de_la_correspondance :
- mot-clé |
valeur par défaut
+ ${
MapName :
+ mot-clé }
+ ${
MapName :
+ mot-clé |
valeur par défaut
}
Lorsqu'une telle construction est rencontrée, la table de - correspondance Nom_de_la_correspondance est consultée - et la clé mot-clé recherchée. Si la clé est trouvée, la - construction est remplacée par - la valeur de remplacement. Si la clé n'est pas trouvée, - elle est remplacée par la valeur par défaut, ou par une - chaîne vide si aucune valeur par défaut n'est - spécifiée. La valeur vide se comporte comme si la - clé était absente ; il est donc impossible de distinguer une - valeur vide d'une absence de clé.
- -Par exemple, vous pouvez définir une directive +
Lorsqu'une telle construction est rencontrée, la table de + correspondance MapName est consultée + et la clé mot-clé recherchée. Si la clé est trouvée, la + construction est remplacée par + la valeur de remplacement. Si la clé n'est pas trouvée, + elle est remplacée par la valeur par défaut, ou par une + chaîne vide si aucune valeur par défaut n'est + spécifiée. La valeur vide se comporte comme si la + clé était absente ; il est donc impossible de distinguer une + valeur vide d'une absence de clé.
+ +Par exemple, vous pouvez définir une directive
La signification de l'argument MapTypeOptions dépend du + MapType. Voir le document Utiliser RewriteMap pour plus de + détails.
+Les combinaisons suivantes pour type de correspondance et source de la correspondance - peuvent être utilisées :
+ peuvent être utilisées :httxt2dbm
(Détails ...).RewriteMap
: toupper, tolower, escape ou unescape
- (Détails ...).Vous trouverez plus de détails et de nombreux exemples dans le Vous trouverez plus de détails et de nombreux exemples dans le RewriteMap HowTo.
La directive
Cette directive est obligatoire si vous utilisez un chemin relatif dans une substitution, et dans un contexte de - répertoire (htaccess), sauf si au moins une de ces conditions est - vérifiée :
+ répertoire (htaccess), sauf si au moins une de ces conditions est + vérifiée :Dans l'exemple ci-dessous, la directive
-
La directive
La directive
TestString est une chaîne qui peut contenir les +
TestString est une chaîne qui peut contenir les extensions suivantes en plus du texte simple :
$N
(0 <= N <= 9). $1 à $9
- permettent d'accéder aux parties regroupées (entre
- parenthèses) du modèle, issues de la RewriteRule
- concernée par le jeu de conditions RewriteCond
- courant. $0 donne accès à l'ensemble de la chaîne
- correspondant au modèle.$N
(0 <= N <= 9). $1 Ã $9
+ permettent d'accéder aux parties regroupées (entre
+ parenthèses) du modèle, issues de la RewriteRule
+ concernée par le jeu de conditions RewriteCond
+ courant. $0 donne accès à l'ensemble de la chaîne
+ correspondant au modèle.
%N
(0 <= N <= 9). %1 à %9
- permettent d'accéder aux parties regroupées (entre
- parenthèses) du modèle, issues de la dernière
+ Références arrières de condition de réécriture
+ : ce sont des références arrières de la forme
+ %N
(0 <= N <= 9). %1 Ã %9
+ permettent d'accéder aux parties regroupées (entre
+ parenthèses) du modèle, issues de la dernière
condition RewriteCond
satisfaite du jeu de conditions RewriteCond
- courant. %0 donne accès à l'ensemble de la chaîne
- correspondant au modèle.${nomTable:clé|défaut}
. Voir la ${nomTable:clé|défaut}. Voir la href="#mapfunc">documentation sur RewriteMap
- pour plus de détails.
+ pour plus de détails.
%{
NAME_OF_VARIABLE }
,
- où NOM_DE_VARIABLE peut contenir une chaîne issue
+ où NOM_DE_VARIABLE peut contenir une chaîne issue
de la liste suivante :
En-têtes HTTP : | connexion & requête: | + | En-têtes HTTP : | connexion & requête: | |
---|---|---|---|---|---|
variables internes au serveur : | date et heure : | spéciaux : | +variables internes au serveur : | date et heure : | spéciaux : |
Ces variables correspondent toutes aux en-têtes MIME
- HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou
- aux champs struct tm
du système Unix. La
- plupart d'entre elles sont documentées Ces variables correspondent toutes aux en-têtes MIME
+ HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou
+ aux champs struct tm
du système Unix. La
+ plupart d'entre elles sont documentées ici, dans la
- spécification CGI ou ailleurs dans le
+ spécification CGI ou ailleurs dans le
manuel.
SERVER_NAME et SERVER_PORT dépendent respectivement +
SERVER_NAME et SERVER_PORT dépendent respectivement
des valeurs des directives
Parmi les variables - spécifiques à mod_rewrite, ou trouve les suivantes :
-API_VERSION
CONN_REMOTE_ADDR
IS_SUBREQ
REMOTE_ADDR
REQUEST_FILENAME
REQUEST_FILENAME
contient la
valeur de REQUEST_URI
. En fonction de la
valeur de la directive REQUEST_URI
pour déterminer à quel
- fichier correspond la requête.REQUEST_URI
pour déterminer à quel
+ fichier correspond la requête.REQUEST_SCHEME
REQUEST_URI
QUERY_STRING
.THE_REQUEST
GET
- /index.html HTTP/1.1
"), à l'exclusion de tout
- en-tête ajouté par le navigateur. Cette
- valeur n'a pas été déséchappée (décodée), à la
- différence de la plupart des variables suivantes.Si chaîne_de_test contient la valeur spéciale
- expr
, expression_de_comparaison sera traité
+
Si chaîne_de_test contient la valeur spéciale
+ expr
, expression_de_comparaison sera traité
en tant qu'expression rationnelle de type ap_expr. Si des en-têtes HTTP sont
- référencés dans l'expression rationnelle, et si le drapeau
- novary
n'est pas activé, ils seront ajoutés à
- l'en-tête Vary.
novary
n'est pas activé, ils seront ajoutés Ã
+ l'en-tête Vary.
- Autres points à connaître ::
+Autres points à connaître ::
Les variables SCRIPT_FILENAME
et
@@ -727,285 +727,299 @@ la réécriture soit effectuée
du champ filename
de la
structure interne request_rec
du serveur HTTP Apache.
Le premier nom correspond au nom de variable bien connu CGI,
- alors que le second est l'équivalent de REQUEST_URI (qui
+ alors que le second est l'équivalent de REQUEST_URI (qui
contient la valeur du champ uri
de
request_rec
).
Si une substitution intervient et si la réécriture se - poursuit, la valeur des deux variables sera mise à jour en - conséquence.
-Dans le contexte du serveur principal (c'est à dire avant que - la requête ne soit mise en correspondance avec le système de +
Si une substitution intervient et si la réécriture se + poursuit, la valeur des deux variables sera mise à jour en + conséquence.
+Dans le contexte du serveur principal (c'est à dire avant que
+ la requête ne soit mise en correspondance avec le système de
fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
- contenir le chemin entier dans le système de fichiers local car
- ce chemin b'est pas connu à ce stade du traitement. Dans ce cas,
+ contenir le chemin entier dans le système de fichiers local car
+ ce chemin b'est pas connu à ce stade du traitement. Dans ce cas,
les deux variables contiendront la valeur de REQUEST_URI. Pour
- obtenir le chemin complet de la requête dans le système de
+ obtenir le chemin complet de la requête dans le système de
fichiers local dans le contexte du serveur principal, utilisez une
- référence avant à base d'URL
- %{LA-U:REQUEST_FILENAME}
pour déterminer la valeur
+ référence avant à base d'URL
+ %{LA-U:REQUEST_FILENAME}
pour déterminer la valeur
finale de REQUEST_FILENAME.
%{ENV:variable}
, où variable peut
- correspondre à une variable d'environnement quelconque.%{ENV:variable}
, où variable peut
+ correspondre à une variable d'environnement quelconque.
%{ENV:variable}
est aussi disponible, où
- variable peut correspondre à toute variable
- d'environnement. Peut être consulté via des structures internes
+ %{ENV:variable}
est aussi disponible, où
+ variable peut correspondre à toute variable
+ d'environnement. Peut être consulté via des structures internes
d'Apache httpd et (si on ne les trouve pas ici) via la fonction
- getenv()
à partir du processus du serveur Apache
+ getenv()
à partir du processus du serveur Apache
httpd.%{SSL:variable}
, où variable
- peut être remplacé par le nom d'une
+ %{SSL:variable}
, où variable
+ peut être remplacé par le nom d'une
variable
d'environnement SSL . Si %{SSL:SSL_CIPHER_USEKEYSIZE}
pourra
contenir la valeur 128
. Ces variables sont
- disponibles même si l'option StdEnvVars
de la
+ disponibles même si l'option StdEnvVars
de la
directive %{HTTP:en-tête}
, où
- en-tête peut correspondre à tout nom d'en-tête MIME
- HTTP, pour extraire la valeur d'un en-tête envoyé dans la
- requête HTTP. Par exemple, %{HTTP:Proxy-Connection}
- contiendra la valeur de l'en-tête HTTP
+ On peut utiliser %{HTTP:en-tête}
, où
+ en-tête peut correspondre à tout nom d'en-tête MIME
+ HTTP, pour extraire la valeur d'un en-tête envoyé dans la
+ requête HTTP. Par exemple, %{HTTP:Proxy-Connection}
+ contiendra la valeur de l'en-tête HTTP
"Proxy-Connection:
".
- Si on utilise un en-tête HTTP
- dans une condition, et si cette condition est évaluée à
- vrai
pour la requête, cet en-tête sera ajouté à l'en-tête Vary de
- la réponse. Il ne le sera pas si la condition est évaluée à
- faux
. L'ajout de l'en-tête HTTP à l'en-tête Vary
- est nécessaire à une mise en cache appropriée.
- Il faut garder à l'esprit que les conditions suivent une
+ Si on utilise un en-tête HTTP
+ dans une condition, et si cette condition est évaluée Ã
+ vrai
pour la requête, cet en-tête sera ajouté à l'en-tête Vary de
+ la réponse. Il ne le sera pas si la condition est évaluée Ã
+ faux
. L'ajout de l'en-tête HTTP à l'en-tête Vary
+ est nécessaire à une mise en cache appropriée.
+
Il faut garder à l'esprit que les conditions suivent une
logique de cout-circuit si le drapeau
- 'ornext|OR
' est utilisé, et que de
- ce fait, certaines d'entre elles ne seront pas évaluées.
ornext|OR
' est utilisé, et que de
+ ce fait, certaines d'entre elles ne seront pas évaluées.
%{LA-U:variable}
, qui
- permet d'effectuer une sous-requête interne à base d'URL, afin
- de déterminer la valeur finale de variable. Ceci permet
- d'accéder à la valeur d'une variable pour la réécriture inconnue
- à ce stade du traitement, mais qui sera définie au
- cours d'une phase ultérieure.
- Par exemple, pour effectuer une réécriture dépendant de la + permet d'effectuer une sous-requête interne à base d'URL, afin + de déterminer la valeur finale de variable. Ceci permet + d'accéder à la valeur d'une variable pour la réécriture inconnue + à ce stade du traitement, mais qui sera définie au + cours d'une phase ultérieure. +
Par exemple, pour effectuer une réécriture dépendant de la
variable REMOTE_USER
dans le contexte du serveur
principal (fichier httpd.conf
), vous devez utiliser
- %{LA-U:REMOTE_USER}
- cette variable est définie
- par la phase d'autorisation qui intervient après la
- phase de traduction d'URL (pendant laquelle mod_rewrite opère).
Par contre, comme mod_rewrite implémente son contexte de
- répertoire (fichier .htaccess
) via la phase Fixup
+ %{LA-U:REMOTE_USER}
- cette variable est définie
+ par la phase d'autorisation qui intervient après la
+ phase de traduction d'URL (pendant laquelle mod_rewrite opère).
Par contre, comme mod_rewrite implémente son contexte de
+ répertoire (fichier .htaccess
) via la phase Fixup
de l'API, et comme la phase d'autorisation intervient
- avant cette dernière, vous pouvez vous contenter
+ avant cette dernière, vous pouvez vous contenter
d'utiliser %{REMOTE_USER}
dans ce contexte.
%{LA-F:variable}
peut être utilisée pour effectuer
- une sous-requête interne (basée sur le nom de fichier), afin de
- déterminer la valeur finale de variable. La plupart du
- temps, elle est identique à LA-U (voir ci-dessus).%{LA-F:variable}
peut être utilisée pour effectuer
+ une sous-requête interne (basée sur le nom de fichier), afin de
+ déterminer la valeur finale de variable. La plupart du
+ temps, elle est identique à LA-U (voir ci-dessus).
expression_de_comparaison est une expression - rationnelle qui est appliquée à l'instance actuelle de - chaîne_de_test. chaîne_de_test est d'abord - évaluée, puis comparée à + rationnelle qui est appliquée à l'instance actuelle de + chaîne_de_test. chaîne_de_test est d'abord + évaluée, puis comparée à l'expression_de_comparaison.
-expression_de_comparaison est en général une +
expression_de_comparaison est en général une expression rationnelle compatible perl, mais vous - disposez des syntaxes supplémentaires suivantes pour effectuer - d'autres tests utiles sur chaîne_de_test : + disposez des syntaxes supplémentaires suivantes pour effectuer + d'autres tests utiles sur chaîne_de_test :
!
' (point d'exclamation) pour inverser le résultat
- de la condition, quelle que soit l'expression_de_comparaison utilisée.!
' (point d'exclamation) pour inverser le résultat
+ de la condition, quelle que soit l'expression_de_comparaison utilisée.""
(deux guillemets),
- chaîne_de_test est comparée à la chaîne vide.'-U' (test de l'existence d'une
- URL via une sous-requête)
- Vérifie si chaîne_de_test est une URL valide,
- accessible à travers tous les contrôles d'accès du serveur
- actuellement configurés pour ce chemin. C'est une
- sous-requête interne qui effectue cette vérification - à
- utiliser avec précautions car les performances du serveur
- peuvent s'en trouver affectées !
test de l'existence d'une URL via une sous-requête
+ Vérifie si chaîne_de_test est une URL valide,
+ accessible à travers tous les contrôles d'accès du serveur
+ actuellement configurés pour ce chemin. C'est une
+ sous-requête interne qui effectue cette vérification - Ã
+ utiliser avec précautions car les performances du serveur
+ peuvent s'en trouver affectées !
Ce drapeau ne renvoie que des informations - concernant le contrôle d'accès, l'authentification et + concernant le contrôle d'accès, l'authentification et l'autorisation. Il ne renvoie pas d'informations - concernant le code d'état que le gestionnaire configuré - (static file, CGI, proxy, etc...) aurait, quant à lui, - retourné.
Si la chaîne_de_test contient la valeur spéciale
- expr
, la chaîne_de_comparaison sera
- traitée en tant qu'expression rationnelle de type Si la chaîne_de_test contient la valeur spéciale
+ expr
, la chaîne_de_comparaison sera
+ traitée en tant qu'expression rationnelle de type ap_expr.
Dans l'exemple ci-dessous, on utilise -strmatch
- pour comparer le REFERER
avec le nom d'hôte du
- site afin de bloquer le hotlinking (référencement direct)
- non désiré.
+ pour comparer le REFERER
avec le nom d'hôte du
+ site afin de bloquer le hotlinking (référencement direct)
+ non désiré.
[
drapeaux]
- comme troisième argument de la directive
- RewriteCond
, où drapeaux est un
- sous-ensemble séparé par des virgules des drapeaux suivants :
+ comme troisième argument de la directive
+ RewriteCond
, où drapeaux est un
+ sous-ensemble séparé par des virgules des drapeaux suivants :
nocase|NC
'
(no case)ornext|OR
'
(ou condition suivante)novary|NV
'
(no vary)Exemple :
-Pour réécrire la page d'accueil d'un site en fonction de
- l'en-tête ``User-Agent:
'' de la requête, vous
+
Pour réécrire la page d'accueil d'un site en fonction de
+ l'en-tête ``User-Agent:
'' de la requête, vous
pouvez utiliser ce qui suit :
La directive
Modèle est une + véritable cheval de trait de la réécriture. La directive peut + apparaître plusieurs fois, chaque instance définissant une + règle de réécriture particulière. L'ordre dans lequel ces règles + sont définies est important - il s'agit de l'ordre dans lequel + les règles seront appliquées au cours du processus de + réécriture.
+ +Modèle est une expression rationnelle - compatible perl. Dans la première règle de réécriture, - l'expression est comparée au (%-decoded) + compatible perl. Dans la première règle de réécriture, + l'expression est comparée au (%-decoded) chemin de l'URL de la - requête, ou, dans un contexte de répertoire (voir + requête, ou, dans un contexte de répertoire (voir ci-dessous), au chemin de l'URL relativement à ce contexte de répertoire. - Les expressions suivantes sont comparées à la sortie de - la dernière règle de réécriture qui + Les expressions suivantes sont comparées à la sortie de + la dernière règle de réécriture qui correspondait.
-Dans un contexte de serveur virtuel
Dans les contextes de répertoire
Si vous souhaitez faire une comparaison sur le nom
- d'hôte, le port, ou la chaîne de requête, utilisez une
+ d'hôte, le port, ou la chaîne de requête, utilisez une
directive %{HTTP_HOST}
, %{SERVER_PORT}
, ou
%{QUERY_STRING}
.
Dans tous les cas, il faut garder à l'esprit que les expressions
+ rationnelles permettent de rechercher des correspondances de sous-chaînes.
+ En d'autres termes, l'expression rationnelle n'a pas besoin de correspondre Ã
+ l'ensemble de la chaîne, mais seulement à la partie que vous souhaitez
+ voir correspondre. Ainsi, l'utilisation de l'expression .
est
+ souvent suffisante et préférable à .*
, et l'expression
+ abc
n'est pas identique à l'expression
+ ^abc$
.
RewriteEngine On
" et
-"Options FollowSymLinks
". Si l'administrateur a désactivé
-la possibilité de modifier l'option FollowSymLinks
au
-niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
-moteur de réécriture. Cette restriction a été instaurée à des fins de
-sécurité..htaccess
, le chemin de base du répertoire courant (qui est
-toujours le même pour ce même répertoire) est automatiquement
-supprimé au cours de la comparaison avec le modèle de la règle
-de réécriture, et automatiquement ajouté lorsqu'une
-substitution relative (ne débutant pas par un slash ou un nom de
-protocole) arrive à la fin d'un jeu de règles. Voir la directive
+RewriteEngine On
" et
+"Options FollowSymLinks
". Si l'administrateur a désactivé
+la possibilité de modifier l'option FollowSymLinks
au
+niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
+moteur de réécriture. Cette restriction a été instaurée à des fins de
+sécurité..htaccess
, le chemin de base du répertoire courant (qui est
+toujours le même pour ce même répertoire) est automatiquement
+supprimé au cours de la comparaison avec le modèle de la règle
+de réécriture, et automatiquement ajouté lorsqu'une
+substitution relative (ne débutant pas par un slash ou un nom de
+protocole) arrive à la fin d'un jeu de règles. Voir la directive
%{REQUEST_URI}
dans la directive
^/
ne correspondra jamais dans un contexte de répertoire.^/
ne correspondra jamais dans un contexte de répertoire.Pour quelques conseils à propos des
Dans mod_rewrite, on peut aussi utiliser le caractère NON
- ('!
') comme préfixe de modèle. Ceci vous permet
- d'inverser la signification d'un modèle, soit pour dire
- ``si l'URL considérée ne correspond PAS à
- ce modèle''. Le caractère NON peut donc être utilisé à
+
Dans mod_rewrite, on peut aussi utiliser le caractère NON
+ ('!
') comme préfixe de modèle. Ceci vous permet
+ d'inverser la signification d'un modèle, soit pour dire
+ ``si l'URL considérée ne correspond PAS Ã
+ ce modèle''. Le caractère NON peut donc être utilisé Ã
titre exceptionnel, lorsqu'il est plus simple d'effectuer une
- comparaison avec le modèle inversé, ou dans la dernière règle
- par défaut.
$N
dans la chaîne de
+Si vous utilisez le caractère NON pour inverser la signification d'un
+modèle, vous ne pouvez pas inclure de parties génériques groupées dans
+le modèle. Ceci est dû au fait que, lorsque le modèle ne correspond
+pas (autrement dit, sa négation correspond), les groupes sont vides.
+Ainsi, si vous utilisez des modèles inversés, vous ne pouvez
+pas vous référer aux groupes par $N
dans la chaîne de
substitution !
Dans une règle de réécriture, - Substitution est la chaîne - de caractères qui remplace le chemin de l'URL original qui - correspondait au Modèle. Substitution peut - être :
+Dans une règle de réécriture, + Substitution est la chaîne + de caractères qui remplace le chemin de l'URL original qui + correspondait au Modèle. Substitution peut + être :
/www/file.html
, cette
- dernière sera traitée comme un chemin d'URL à moins
- qu'un répertoire nommé www
n'existe à la racine
- de votre système de fichiers (ou dans le cas d'une
- réécriture au sein d'un fichier .htaccess
,
- relativement à la racine des documents), auquel cas la chaîne de
- substitution sera traitée comme un chemin du système de
- fichiers. Si vous désirez que d'autres directives de
+ dernière sera traitée comme un chemin d'URL à moins
+ qu'un répertoire nommé www
n'existe à la racine
+ de votre système de fichiers (ou dans le cas d'une
+ réécriture au sein d'un fichier .htaccess
,
+ relativement à la racine des documents), auquel cas la chaîne de
+ substitution sera traitée comme un chemin du système de
+ fichiers. Si vous désirez que d'autres directives de
correspondance d'URL (comme la directive [PT]
- comme décrit ci-dessous.[PT]
+ comme décrit ci-dessous.
[R]
ci-dessous.-
(tiret)En plus du texte, la chaîne Substition peut +
En plus du texte, la chaîne Substition peut comporter :
$N
) vers le modèle
+ $N
) vers le modèle
d'une directive RewriteRule%N
) vers le dernier
- modèle d'une directive RewriteCond qui correspondait%N
) vers le dernier
+ modèle d'une directive RewriteCond qui correspondait%{VARNAME}
)%{VARNAME}
)${nom correspondance:clé|défaut}
)${nom correspondance:clé|défaut}
)
Les références arrières sont des identificateurs de la forme +
Les références arrières sont des identificateurs de la forme
$
N (N=0..9), qui
- seront remplacés par le contenu du Nème groupe
- du Modèle qui correspondait. Les variables du serveur
- sont les mêmes que dans la Chaîne de test d'une
+ seront remplacés par le contenu du Nème groupe
+ du Modèle qui correspondait. Les variables du serveur
+ sont les mêmes que dans la Chaîne de test d'une
directive RewriteCond
. Les fonctions de comparaison
sont issues de la directive RewriteMap
dans la
- section de laquelle elles sont décrites. Ces trois types de
- variables sont évaluées dans l'ordre ci-dessus.
Chaque règle de réécriture s'applique au résultat de la règle - précédente, selon l'ordre dans lequel elles ont été définies dans - le fichier de configuration. Le chemin de l'URL ou du système de fichier (voir +
Chaque règle de réécriture s'applique au résultat de la règle
+ précédente, selon l'ordre dans lequel elles ont été définies dans
+ le fichier de configuration. Le chemin de l'URL ou du système de fichier (voir
ci-dessus Qu'est-ce qui est
- comparé ?) est intégralement
- remplacée par la chaîne de Substitution et le
- processus de réécriture se poursuit jusqu'à ce que toutes les
- règles aient été appliquées, ou qu'il soit explicitement stoppé
+ comparé ?) est intégralement
+ remplacée par la chaîne de Substitution et le
+ processus de réécriture se poursuit jusqu'à ce que toutes les
+ règles aient été appliquées, ou qu'il soit explicitement stoppé
par un drapeau L
,
- ou par un autre drapeau qui implique un arrêt immédiat, comme
+ ou par un autre drapeau qui implique un arrêt immédiat, comme
END
ou
F
.
Par défaut, la chaîne de requête est transmise sans
- modification. Vous pouvez cependant créer dans la chaîne de
- substitution des URLs dont une partie constitue une chaîne de
- requête. Pour cela, ajoutez simplement un point d'interrogation
- dans la chaîne de substitution pour indiquer que le texte qui
- suit doit être réinjecté dans la chaîne de requête. Pour
- supprimer une chaîne de requête, terminez simplement la chaîne de
+ Par défaut, la chaîne de requête est transmise sans
+ modification. Vous pouvez cependant créer dans la chaîne de
+ substitution des URLs dont une partie constitue une chaîne de
+ requête. Pour cela, ajoutez simplement un point d'interrogation
+ dans la chaîne de substitution pour indiquer que le texte qui
+ suit doit être réinjecté dans la chaîne de requête. Pour
+ supprimer une chaîne de requête, terminez simplement la chaîne de
substitution par un point d'interrogation. Pour combiner les
- nouvelles chaînes de requête avec les anciennes, utilisez le
+ nouvelles chaînes de requête avec les anciennes, utilisez le
drapeau [QSA]
.
En outre, vous pouvez spécifier des actions spéciales à effectuer en ajoutant +
En outre, vous pouvez spécifier des actions spéciales à effectuer en ajoutant
des
[
drapeaux]
- comme troisième argument de la directive
- RewriteRule
. Séparés par des virgules au sein d'une
- liste encadrée par des crochets, les drapeaux peuvent
- être choisis dans la table suivante. Vous trouverez plus de
- détails, et des exemples pour chaque drapeau dans le document à propos des drapeaux de
- réécriture.
RewriteRule
. Séparés par des virgules au sein d'une
+ liste encadrée par des crochets, les drapeaux peuvent
+ être choisis dans la table suivante. Vous trouverez plus de
+ détails, et des exemples pour chaque drapeau dans le document à propos des drapeaux de
+ réécriture.
Drapeaux et syntaxe | @@ -1350,153 +1373,163 @@ substitution !||
---|---|---|
B | -Echappe les caractères non-alphanumériques avant - d'appliquer la transformation. détails ... | +Echappe les caractères non-alphanumériques dans les + références arrières avant d'appliquer la transformation. détails ... |
backrefnoplus|BNP | +Avec ce drapeau, si les références arrières sont échappées, + les espaces seront échappés en %20 au lieu de +. Ceci s'avère + utile lorsqu'une référence arrière est utilisée dans la partie + chemin, et non dans la chaîne de paramètres de la requête ; + pour plus de détails, voir ici. | +|
chain|C | -La règle est chaînée avec la règle suivante. Si la règle - échoue, la ou les règles avec lesquelles elle est est chaînée - seront sautées. détails ... | +La règle est chaînée avec la règle suivante. Si la règle + échoue, la ou les règles avec lesquelles elle est est chaînée + seront sautées. détails ... |
cookie|CO=NAME:VAL | -Définit un cookie au niveau du navigateur client. La syntaxe - complète est : + | Définit un cookie au niveau du navigateur client. La syntaxe + complète est : CO=NAME:VAL:domain[:lifetime[:path[:secure[:httponly]]]] details ... - détails ... + détails ... |
discardpath|DPI | -Supprime la partie PATH_INFO de l'URI réécrit. détails
+ Supprime la partie PATH_INFO de l'URI réécrit. détails
... |
|
END | -Stoppe le processus de réécriture immédiatement et - n'applique plus aucune règle. Empêche aussi l'application - ultérieure de règles de réécriture dans les contextes de - répertoire et de fichier .htaccess (disponible à partir de la + | Stoppe le processus de réécriture immédiatement et + n'applique plus aucune règle. Empêche aussi l'application + ultérieure de règles de réécriture dans les contextes de + répertoire et de fichier .htaccess (disponible à partir de la version 2.3.9 du serveur HTTP Apache). détails ... | + href="../rewrite/flags.html#flag_end">détails ...
env|E=[!]VAR[:VAL] | -Définit la variable d'environnement VAR (à la valeur + | Définit la variable d'environnement VAR (à la valeur VAL si elle est fournie). La variante !VAR - annule la définition de la variable VAR.détails ... | + annule la définition de la variable VAR.détails ...
forbidden|F | -Renvoie une réponse 403 FORBIDDEN au navigateur client. - détails ... | +Renvoie une réponse 403 FORBIDDEN au navigateur client. + détails ... |
gone|G | Renvoie un message d'erreur 410 GONE au navigateur client. détails ... | + href="../rewrite/flags.html#flag_g">détails ...|
Handler|H=Gestionnaire de contenu | -L'URI résultant est envoyé au Gestionnaire de
+ L'URI résultant est envoyé au Gestionnaire de
contenu pour traitement. détails ... |
+ href="../rewrite/flags.html#flag_h">détails ... |
last|L | -Arrête le processus de réécriture immédiatement et n'applique - plus aucune règle. Prêtez une attention particulière aux mises - en garde concernant les contextes de niveau répertoire et + | Arrête le processus de réécriture immédiatement et n'applique + plus aucune règle. Prêtez une attention particulière aux mises + en garde concernant les contextes de niveau répertoire et .htaccess (voir aussi le drapeau END). détails ... | + href="../rewrite/flags.html#flag_l">détails ...
next|N | -Réexécute le processus de réécriture à partir de la première
- règle, en utilisant le résultat du jeu de règles, sous réserve
- qu'il y ait un point de départ. détails
+ Réexécute le processus de réécriture à partir de la première
+ règle, en utilisant le résultat du jeu de règles, sous réserve
+ qu'il y ait un point de départ. détails
... |
|
nocase|NC | -Rend la comparaison entre modèles insensible à la casse. - détails ... | +Rend la comparaison entre modèles insensible à la casse. + détails ... |
noescape|NE | -Empêche mod_rewrite d'effectuer un échappement hexadécimal - des caractères spéciaux dans le résultat de la réécriture. détails ... | +Empêche mod_rewrite d'effectuer un échappement hexadécimal + des caractères spéciaux dans le résultat de la réécriture. détails ... |
nosubreq|NS | -La règle est sautée si la requête courante est une - sous-requête interne. détails ... | +La règle est sautée si la requête courante est une + sous-requête interne. détails ... |
proxy|P | Force l'envoi en interne de l'URL de substitution en tant - que requête mandataire. détails + que requête mandataire. détails ... | |
passthrough|PT | -L'URI résultant est repassé au moteur de mise en - correspondance des URLs pour y être traité par d'autres + | L'URI résultant est repassé au moteur de mise en
+ correspondance des URLs pour y être traité par d'autres
traducteurs URI-vers-nom de fichier, comme Alias ou
Redirect . détails ... |
+ href="../rewrite/flags.html#flag_pt">détails ...
qsappend|QSA | -Ajoute toute chaîne de paramètres présente dans l'URL de la - requête originale à toute chaîne de paramètres créée dans la - cible de réécriture. détails ... | +Ajoute toute chaîne de paramètres présente dans l'URL de la + requête originale à toute chaîne de paramètres créée dans la + cible de réécriture. détails ... |
qsdiscard|QSD | -Supprime toute chaîne de paramètres de l'URI entrant. détails
+ Supprime toute chaîne de paramètres de l'URI entrant. détails
... |
|
redirect|R[=code] | Force une redirection externe, avec un code de statut HTTP optionnel. détails ... + href="../rewrite/flags.html#flag_r">détails ... | |
skip|S=nombre | -Si la règle courante s'applique, le moteur de réécriture - doit sauter les nombre règles suivantes. détails ... | +Si la règle courante s'applique, le moteur de réécriture + doit sauter les nombre règles suivantes. détails ... |
type|T=MIME-type | Force l'attribution du |
+ spécifié au fichier cible. détails ...
Quand la chaîne de substitution commence par quelque chose comme
-"/~user" (de manière explicite ou par références arrières), mod_rewrite
-développe le répertoire home sans tenir compte de la présence ou de la
+ Quand la chaîne de substitution commence par quelque chose comme
+"/~user" (de manière explicite ou par références arrières), mod_rewrite
+développe le répertoire home sans tenir compte de la présence ou de la
configuration du module Ce développement n'est pas effectué si le drapeau PT est
-utilisé dans la directive Ce développement n'est pas effectué si le drapeau PT est
+utilisé dans la directive
Voici toutes les combinaisons de substitution et leurs
@@ -1504,29 +1537,29 @@ utilisé dans la directive httpd.conf
)
- pour la requête ``GET
+ pour la requête ``
GET
/chemin/infochemin
'':
Règle | -Résultat de la substitution | +Règle | +Résultat de la substitution |
---|---|---|---|
^/un_chemin(.*) autre_chemin$1 | -invalide, non supporté | +invalide, non supporté | |
^/un_chemin(.*) autre_chemin$1 [R] | -invalide, non supporté | +invalide, non supporté | |
^/un_chemin(.*) autre_chemin$1 [P] | -invalide, non supporté | +invalide, non supporté | |
^/un_chemin(.*) /autre_chemin$1 [P] | -sans objet, non supporté | +sans objet, non supporté | |
^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P] | -sans objet, non supporté | +sans objet, non supporté | |
Dans une configuration de niveau répertoire pour
+ Dans une configuration de niveau répertoire pour
/chemin
(/chemin/physique/vers/chemin/.htacccess
, avec
- RewriteBase /chemin
)
- pour la requête ``GET
+
RewriteBase "/chemin"
)
+ pour la requête ``GET
/chemin/chemin-local/infochemin
'':
-
Règle
-Résultat de la substitution
+Règle
+Résultat de la substitution
@@ -1598,13 +1631,13 @@ redondant)
^chemin-local(.*) autre-chemin$1 [R]
-http://cet-hôte/chemin/autre-chemin/infochemin via redirection
+ http://cet-hôte/chemin/autre-chemin/infochemin via redirection
externe
^chemin-local(.*) autre-chemin$1 [P]
-n'a pas lieu d'être, non supporté
+n'a pas lieu d'être, non supporté
@@ -1614,43 +1647,43 @@ externe
^chemin-local(.*) /autre-chemin$1 [R]
-http://cet-hôte/autre-chemin/infochemin via redirection externe
+http://cet-hôte/autre-chemin/infochemin via redirection externe
^chemin-local(.*) /autre-chemin$1 [P]
-n'a pas lieu d'être, non supporté
+n'a pas lieu d'être, non supporté
-
^chemin-local(.*) http://cet-hôte/autre-chemin$1
+^chemin-local(.*) http://cet-hôte/autre-chemin$1
/autre-chemin/infochemin
-
^chemin-local(.*) http://cet-hôte/autre-chemin$1 [R]
-http://cet-hôte/autre-chemin/infochemin via redirection externe
+^chemin-local(.*) http://cet-hôte/autre-chemin$1 [R]
+http://cet-hôte/autre-chemin/infochemin via redirection externe
-
^chemin-local(.*) http://cet-hôte/autre-chemin$1 [P]
-n'a pas lieu d'être, non supporté
+^chemin-local(.*) http://cet-hôte/autre-chemin$1 [P]
+n'a pas lieu d'être, non supporté
-
^chemin-local(.*) http://autre hôte/autre-chemin$1
-http://autre hôte/autre-chemin/infochemin via redirection externe
+^chemin-local(.*) http://autre hôte/autre-chemin$1
+http://autre hôte/autre-chemin/infochemin via redirection externe
-
^chemin-local(.*) http://autre hôte/autre-chemin$1 [R]
-http://autre hôte/autre-chemin/infochemin via redirection externe
+ ^chemin-local(.*) http://autre hôte/autre-chemin$1 [R]
+http://autre hôte/autre-chemin/infochemin via redirection externe
(le drapeau [R] est redondant)
-
^chemin-local(.*) http://autre hôte/autre-chemin$1 [P]
-http://autre hôte/autre-chemin/infochemin via un mandataire interne
+^chemin-local(.*) http://autre hôte/autre-chemin$1 [P]
+http://autre hôte/autre-chemin/infochemin via un mandataire interne