How to debug Apache mod_rewrite
ApacheMod RewriteApache Problem Overview
I have two main problems with mod_rewrite:
-
There is no meaningful error reported when I have an invalid rule
-
To reliably test each modification, I have to erase Google Chrome's cache. This isn't rocket science, but I have to hit Ctrl + Shift + Delete, click OK, and close the window, and reload.
I'd like to see if any of the gurus are willing to share their secrets to efficiently managing mod_rewrite code.
Apache Solutions
Solution 1 - Apache
One trick is to turn on the rewrite log. To turn it on, try this line in your Apache HTTP Server main configuration or current virtual host file (not in .htaccess
):
LogLevel alert rewrite:trace6
Before Apache httpd 2.4 mod_rewrite, such a per-module logging configuration did not exist yet. Instead you could use the following logging settings:
RewriteEngine On
RewriteLog "/var/log/apache2/rewrite.log"
RewriteLogLevel 3
Solution 2 - Apache
The RewriteLog directive as mentioned by Ben is not available any more in Apache 2.4.
You need to use the LogLevel directive instead. E.g.,
LogLevel alert rewrite:trace6
Solution 3 - Apache
For basic URL resolution, use a command line fetcher like wget
or curl
to do the testing, rather than a manual browser. Then you don't have to clear any cache; just up arrow and press Enter in a shell to rerun your test fetches.
Solution 4 - Apache
There's the htaccess tester.
It shows which conditions were tested for a certain URL, which ones met the criteria and which rules got executed.
It seems to have some glitches, though.
Solution 5 - Apache
Based on Ben's answer, you could do the following when running Apache on Linux (Debian in my case).
First create the file rewrite-log.load.
/etc/apache2/mods-availabe/rewrite-log.load
RewriteLog "/var/log/apache2/rewrite.log"
RewriteLogLevel 3
Then enter
> $ a2enmod rewrite-log
followed by
> $ service apache2 restart
And when you are finished with debugging your rewrite rules,
> $ a2dismod rewrite-log && service apache2 restart