Réécriture d’url et erreur interne à Apache

Il arrive que lors de l’écriture d’un nombre complexe de règle de réécriture d’URL (URL rewriting), des erreurs se produisent sans pour autant être compréhensibles. Je vous propose donc de regarder comment déboguer cela à travers un exemple pratique.

Exemple

Prenons une règles qui vérifierait que seul certains type de caractère sont autorisés.
La réécriture quant à elle se fait sur toute URL.
Ajoutons un document 403 personnalisé
RewriteEngine on
#
RewriteCond %{THE_REQUEST} !^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/ [NC]
RewriteRule .* - [F,NS,L]
#
#if not a dir or a file
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
#
RewriteRule ^(.*)$ index.php?p=$1 [QSA,L]
ErrorDocument 403 /erreur/403

Testons l’URL http://localhost/test:s et on obtient un beau :

Forbidden

You don’t have permission to access /test:s on this server.

Additionally, a 500 Internal Server Error error was encountered while trying to use an ErrorDocument to handle the request.

Les logs d’erreurs d’Apache vous diront certainement quelque chose du genre :

[error] [client 127.0.0.1] Request exceeded the limit of 10 internal redirects due to probable configuration error. Use ‘LimitInternalRecursion’ to increase the limit if necessary. Use ‘LogLevel debug’ to get a backtrace.

Passage en mode debug de Apache

Modifions la règle de log du site courant (soit dans /etc/apache2/sites-available/default soit dans /etc/apache2/apache.conf ou l’équivalent suivant votre configuration ou OS) et modifions la directive « LogLevel warn » en « LogLevel debug ». Ceci ne change rien dans notre cas, mais parfois cela s’avère utile…

Ajoutons ensuite les log1 de réécriture d’url (moi je l’ai ajouter dans /etc/apache2/mods-available/rewrite.conf puis j’ai fait un a2enmod rewrite (car le fichier .conf n’existait pas) et enfin j’ai relancer Apache) :
<IfModule mod_rewrite.c>
RewriteLog "/var/log/apache2/rewrite.log"
RewriteLogLevel 9
</IfModule>

Maintenant si vous aller voir dans error.log vous aurez :

[error] [client 127.0.0.1] Request exceeded the limit of 10 internal redirects due to probable configuration error. Use ‘LimitInternalRecursion’ to increase the limit if necessary. Use ‘LogLevel debug’ to get a backtrace.
[debug] core.c(3063): [client 127.0.0.1] r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/erreur/403
[debug] core.c(3069): [client 127.0.0.1] redirected from r->uri = /…/test:s

Donc on voit que la redirection s’effectue correctement mais qu’il « n’accroche » pas. Regardons donc les logs de la réécriture d’URL (rewrite.log) :

/initial] (3) [perdir /…/] strip per-dir prefix: /…/test:s -> test:s
/initial] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘test:s’
/initial] (4) [perdir /…/] RewriteCond: input= » pattern=’200′ => not-matched
/initial] (3) [perdir /…/] strip per-dir prefix: /…/test:s -> test:s
/initial] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘test:s’
/initial] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial] (2) [perdir /…/] forcing responsecode 403 for /…/test:s
/initial/redir#1] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#1] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#1] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#1] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#1] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#1] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#1] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#1] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#1] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#2] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#2] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#2] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#2] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#2] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#2] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#2] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#2] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#2] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#3] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#3] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#3] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#3] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#3] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#3] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#3] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#3] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#3] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#4] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#4] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#4] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#4] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#4] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#4] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#4] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#4] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#4] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#5] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#5] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#5] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#5] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#5] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#5] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#5] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#5] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#5] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#6] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#6] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#6] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#6] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#6] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#6] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#6] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#6] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#6] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#7] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#7] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#7] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#7] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#7] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#7] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#7] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#7] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#7] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#8] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#8] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#8] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#8] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#8] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#8] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#8] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#8] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#8] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#9] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#9] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#9] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#9] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#9] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#9] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#9] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#9] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#9] (2) [perdir /…/] forcing responsecode 403 for /…/erreur
/initial/redir#10] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#10] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#10] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#10] (4) [perdir /…/] RewriteCond: input=’403′ pattern=’200’ => not-matched
/initial/redir#10] (3) [perdir /…/] add path info postfix: /…/erreur -> /…/erreur/403
/initial/redir#10] (3) [perdir /…/] strip per-dir prefix: /…/erreur/403 -> erreur/403
/initial/redir#10] (3) [perdir /…/] applying pattern ‘.*’ to uri ‘erreur/403′
/initial/redir#10] (4) [perdir /…/] RewriteCond: input=’GET /…/test:s HTTP/1.1′ pattern=’!^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/’ [NC] => matched
/initial/redir#10] (2) [perdir /…/] forcing responsecode 403 for /…/erreur

En gros, nous avions une boucle de redirection. Pour l’éviter ajoutons,d ans le .htaccess, une condition qui dira de ne pas rentrer dans le bloc, s’il y a une erreur 403 :
RewriteEngine on
#
RewriteCond %{ENV:REDIRECT_STATUS} !403
RewriteCond %{THE_REQUEST} !^[A-Z]{3,9}\ [a-zA-Z0-9\.\+_/\-\?\=\&]+\ HTTP/ [NC]
RewriteRule .* - [F,NS,L]
#
#if not a dir or a file
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
#
RewriteRule ^(.*)$ index.php?p=$1 [QSA,L]
ErrorDocument 403 /erreur/403

Maintenant tout fonctionne comme prévu!

La fin

Pour finir, ceci montre encore l’importance des logs lors de la rencontre de problème. S’il y a moyen penser a les activer, cela simplifie franchement la tâche de débogage que cela soit pour Apache mais aussi pour tout projet informatique.

Un dernier conseil, pensez a désactiver le mode debug de Apache une fois fini!

S’il y avait un site a conseiller sur ce sujet (en dehors du manuel Apache) je vous renverrait vers askapache

  1. Si le fichier ne se créer pas tout seul penser à le créer

Wampserver : quick switch xdebug menu

Pour une fois, un article sous Ms Windows. Stage oblige, je passe du temps sous celui-ci (XP 🙁 ). Afin d’optimiser son travail, il y a parfois des petites choses bien pratiques, telles que ce que je vais vous présenter.

XDebug est un outil merveilleux, parfois capricieux, certes, mais très utile. Il permet, notamment1 :

  • Affichage de tracé d’erreur
  • Meilleures lectures des exceptions
  • Débogage pas-à-pas
  • Profiling d’application

Bref, des choses essentielles en développement. Et, contrairement à ce que certains IDE2 font, il permet surtout de le faire sur un serveur « réel », donc avec une utilisation « réel ».

Le but de ce billet n’est pas de présenter XDebug, d’autres le font mieux que moi 3, mais bien de vous présenter un petit script vous permettant d’activer et désactiver XDebug sur wampserver.

Installation

  1. Téléchargez le fichier 4 et décompressez-le.
  2. Suivez les instructions d’installation décrite dans le fichier installe. Il y a seulement 1 fichier à modifier + 1 fichier par version de PHP installée.
  3. Relancer wampserver et tester!

Si vous avez des questions, n’hésitez pas.

Plus d’informations

  1. On parle de serveur web avec PHP …
  2. Par exemple, Zend Studio permet un débogage pas à pas mais en interne donc réduit …
  3. cf. plus d’informations
  4. XDebug quick switch menu for wampserver