URL-rewriting: wat is het en hoe gaat het?

URL-rewrite in Apache: mod_rewrite

Om mod_rewrite in Apache te gebruiken, moet de rewrite engine geactiveerd worden met de aanwijzing RewriteEngine on. Hierop volgt de RewriteRule, die met behulp van zogenaamde reguliere expressies (‘regular expressions’, regex) de instructies voor het herschrijven van URL's definieert:

RewriteEngine on
RewriteRule ^/artikel/(.*)$ /a/index.php?title=$1

Als de RewriteRule een omleiding definieert, bevat deze twee parameters: het zoekpatroon en het doelpatroon.

• Zoekpatroon - Deze parameter beschrijft de URL's die moeten worden omgeleid. Een bepaalde voorwaarde wordt gedefinieerd in de vorm van een tekenreeks. Als aan deze voorwaarde is voldaan, vindt omleiding naar een URL plaats volgens het doelpatroon. In het voorbeeld staat het zoekpatroon in dit deel van de RewriteRule: ^/artikel/(.*
• Doelpatroon - Deze parameter beschrijft de URL waarnaar wordt omgeleid. Als de omleiding op server-niveau is geconfigureerd, wordt de volledige URL vervangen. Op directory-niveau in het .htaccess-bestand of in httpd.conf wordt alleen het pad vanaf de huidige directory vervangen. In het voorbeeld staat het doelpatroon in dit deel van de RewriteRule: /a/index.php?title=$1.

In onderstaande tabel zie je een toelichting van de reguliere expressies in ons voorbeeld:

De RewriteRule ^/artikel/(.*)$ /a/index.php?title=$1 legt dus de regel vast, dat bij alle URL’s die beginnen met de string /artikel/(.*), dit deel wordt omgeschreven naar het dynamische URL-schema /a/index.php?title=$1, waarbij $1 staat voor de string die bij de placeholder (.*) hoort.

Als een internetgebruiker de statische URL http://voorbeeld.com/artikel/paginatitel in de webbrowser invoert, schrijft de webserver dit om naar de dynamische URL http://voorbeeld.com/a/index.php?title=paginatitel via mod_rewrite. Dit gebeurt intern en is onzichtbaar voor de gebruiker. In dit geval komen de placeholder (.*) en variabele $1 overeen met de tekenreeks paginatitel.

Moet de URL-rewriting gekoppeld worden aan bepaalde opties die het gedrag van mod_rewrite sturen, dan zet je deze na de RewriteRule tussen vierkante haakjes en (als er meerdere opties gelden) scheid je ze met komma’s. Op deze manier kun je ook externe omleiding via HTTP-statuscode realiseren. De onderstaande tabel toont een aantal opties voor de RewriteRule. Op de officiële website van de Apache Software Foundation vind je een volledige lijst.

Op basis van een dergelijke optie kan je een externe omleiding via HTTP-statuscode als volgt realiseren:

RewriteEngine On
RewriteRule ^oudepagina.html$ /nieuwepagina.html [R=301]

Naast RewriteRules kun je mod_rewrite gebruiken om zogenaamde RewriteConds te definiëren, waarmee websiteheerders aanvullende voorwaarden voor een URL-rewrite kunnen definiëren.

De RewriteCond staat vóór de RewriteRule en heeft deze syntaxis:

RewriteCond TESTSTRING CONDITION

De teststring bevat over het algemeen zogenaamde servervariabelen, gedefinieerd door een procentteken en accolades, zoals %{HTTP_HOST}. In onderstaande tabel zie je een aantal servervariabelen.

Het volgende voorbeeld laat een RewriteCond zien, die een RewriteRule bindt aan het IP-adres van een gebruiker van de webserver:

RewriteCond %{REMOTE_ADDR} 173.45.68.79

URL-rewriting in nginx

Ook de nginx-webserver ondersteunt standaard URL-rewriting. Dit gebeurt eveneens met behulp van reguliere expressies. Om URL's te herschrijven, voeg je de rewrite-opdracht gewoon in een {[...] }-blok in; volgens de nginx-syntaxis. Dat doe je in het webserver-configuratiebestand /etc/nginx/nginx.conf:

location /artikel {
	rewrite ^/artikel/(.*)$ /index.php?title=$1 last;
}

Met location /artikel geven websitebeheerders aan dat de URL-rewrite betrekking heeft op de subdirectory artikel. De reguliere rewrite-expressies zijn dezelfde als op de Apache-webserver en worden ingeleid met de opdracht rewrite. De flag last geeft aan dat het herschrijven intern moet gebeuren, en dus zonder omleiding. Als alternatief zijn er flags voor een tijdelijke of permanente omleiding:

Als je geen flag gebruikt, grijpt nginx automatisch terug op de HTTP-foutcode 500.

Rewrite in lighttpd

In lighttpd realiseer je een URL-rewrite met de functie url.rewrite-TYP. De placeholder TYP staat voor verschillende rewrite-configuratieopties:

Aangezien lighttpd voor URL-rewrites dezelfde reguliere expressies gebruikt als Apache, is de syntaxis in principe op dezelfde manier opgebouwd:

url.rewrite-once = (
	"^/artikel/(.*)$" => "/index.php?title=$1"
)

Als er een externe omleiding moet plaatsvinden − in plaats van een interne rewrite − gebruikt lighttpd niet de rewrite-module, maar een redirect-module. De URL’s gaan hierbij eerst door de rewrite-module en dan door de redirect-module.

De URL-rewrite in Microsoft IIS

Microsoft IIS (Internet Information Services) is een platform zonder native rewrite engine. Je kunt deze echter alsnog aan de webserver toevoegen met de module IIS URL Rewrite 2.0. Microsoft-gebruikers kunnen hun websitebezoekers dus ook voorzien van duidelijke URL's, zonder hiervoor de interne bestandsstructuur te hoeven veranderen. De URL-rewriting-extensie wordt direct na het downloaden geïntegreerd in de IIS Manager-interface. Daar kun je de RewritingRules via een grafische gebruikersinterface invoeren. IIS URL Rewrite 2.0 gebruikt eveneens reguliere expressies om URL-zoek- en doelpatronen te definiëren.