mod_rewrite

1. mod_rewrite Bert Pattyn May 2011

2. Wat? • Apache module • Zwitsers mes voor URL manipulatie • op server niveau: httpd.conf • op directory niveau: .htaccess

3. Waarom gebruiken? • Verbergen van de echte URLs • Propere URLs • SEO (oh yeah...) • Redirect naar andere pagina • Toegangscontrole

4. Geïnstalleerd? Zet volgende in .htaccess RewriteEngine On Error indien niet beschikbaar

5. Directives • RewriteEngine • RewriteCond • RewriteRule • RewriteOption • RewriteLog • RewriteBase • en meer!

6. Voorbeeld 1: Fork RewriteEngine On RewriteBase / RewriteCond %{REQUEST_URI} ^/backend/$ RewriteRule . index.php [NC,L] RewriteCond %{REQUEST_URI} !^$ RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . index.php [NC,L]

7. Voorbeeld 1: Fork # activeer Rewriting Engine RewriteEngine On # base alle rewrite op de ‘/’ URL RewriteBase / # backend is een bestaande directory die behandeld moet worden # als ieder andere file RewriteCond %{REQUEST_URI} ^/backend/$ RewriteRule . index.php [NC,L] # als de URL niet leeg is RewriteCond %{REQUEST_URI} !^$ # ... en het bestand bestaat niet RewriteCond %{REQUEST_FILENAME} !-f # ... en de directory bestaat niet RewriteCond %{REQUEST_FILENAME} !-d # rewrite de url naar /index.php RewriteRule . index.php [NC,L]

8. RewriteEngine On • activeert de rewriting engine • verplicht als eerste regel voor alle andere regels

9. RewriteRule pattern result [ﬂags] • kan meer dan 1 keer voorkomen • worden in volgorde afgehandeld • eerste regel wordt toegepast op de volledige URL • volgende regels gebruiken het resultaat van de vorige regel

10. RewriteRule pattern result [ﬂags] • PCRE (Perl-Compatible Regular Expressions) • vergelijkt met het URL gedeelte (zonder domein) • RewriteCond nodig om andere stukken te vergelijken

11. RewriteRule pattern result [ﬂags] kan één van de volgende items zijn: • ﬁlesystem path ( /kip/ei.pdf ) • URL path • volledige URL (met domein) • -

12. RewriteRule pattern result [ﬂags] • beïnvloedt het gedrag van de Rule • tussen vierkante haakjes [NC] • meerdere ﬂags gescheiden door komma’s [NC, QSA, L]

13. RewriteRule pattern result [ﬂags]

14. RewriteRule pattern result [ﬂags] C Chain this rule to the next rule E Set environment variable F 403 Forbidden Status G 410 Gone Status H Specify handler L Don’t process rules after this one NC Case-insensitive QSA Append query string R[=301] Redirect (R=HTTP Status Code)

23. RewriteCond variable pattern [ﬂags] • HTTP Server Variables (HTTP_HOST, REQUEST_URI) • pattern wordt vergeleken met de waarde van deze var • ﬂags die het gedrag van de Condition veranderen (net zoals bij een RewriteRule)

24. RewriteCond variable pattern [ﬂags]

25. RewriteCond variable pattern [ﬂags] HTTP_REFERER HTTP_HOST REMOTE_ADDR REQUEST_METHOD SERVER_PORT HTTP_USER_AGENT REQUEST_URI etc.

33. 1. Fork (opnieuw) # activeer Rewriting Engine RewriteEngine On # base alle rewrite op de ‘/’ URL RewriteBase / # backend is een bestaande directory die behandeld moet worden # als ieder andere file RewriteCond %{REQUEST_URI} ^/backend/$ RewriteRule . index.php [NC,L] # als de URL niet leeg is RewriteCond %{REQUEST_URI} !^$ # ... en het bestand bestaat niet RewriteCond %{REQUEST_FILENAME} !-f # ... en de directory bestaat niet RewriteCond %{REQUEST_FILENAME} !-d # rewrite de url naar /index.php RewriteRule . index.php [NC,L]

34. 2. non-www naar www RewriteEngine On RewriteCond %{HTTP_HOST} ^example.com$ [NC] RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L] pattern ﬂags result

35. 2. non-www naar www RewriteEngine On RewriteCond %{HTTP_HOST} ^example.com$ [NC] RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L] vergelijk met deze pattern pattern binnen ronde haakjes variable ‘$1’

36. 2. non-www naar www RewriteEngine On RewriteCond %{HTTP_HOST} ^example.com$ [NC] RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L] vervang door “http://www.example.com”

37. 2. non-www naar www RewriteEngine On RewriteCond %{HTTP_HOST} ^example.com$ [NC] RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L] de waarde die binnen de ronde haakjes is opgevangen

38. 2. non-www naar www RewriteEngine On RewriteCond %{HTTP_HOST} ^example.com$ [NC] RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L] Redirect met een 301 code Maak dit de laatste RewriteRule

39. 3. no porn guys on sunday RewriteEngine On RewriteCond %{TIME_WDAY} 0 RewriteCond %{HTTP_REFERER} (porn) [NC] RewriteRule .* - [F]

40. 4. test stadium RewriteEngine On RewriteCond %{REMOTE_ADDR} !^8.82.245.147$ RewriteRule .* /temp/index.html [R, NC, L]

41. RewriteOptions inherit • neem de config over van de parent • in virtual server context, neem alle rules over die op serverniveau gedefinieerd staan • in directory context, neem alle context, condities en rules over die gedefinieerd staan in de parent

42. RewriteBase path • zet de basis voor de rewrites

43. RewriteBase path # /abc/def/.htaccess -- config file voor de directory /abc/def # Belangrijk: /abc/def is het fysieke path voor /xyz # de server heeft een 'Alias /xyz /abc/def' directive RewriteEngine On # laat de server weten dat we komen via /xyz en niet # via het fysieke path /abc/def RewriteBase /xyz # the rewriting rules RewriteRule ^oldstuff.html$ newstuff.html # /xyz/oldstuff.html wordt hier dus herschreven naar /abc/def/newstuff.html

44. RewriteLog log-path • logs rewrites wel, duh... • relatieve paths zijn relatief ten opzichte van de DocumentRoot • absolute paths zijn ... euhm ... absoluut

45. RewriteLogLevel level • integer 0 - 9 • 0 = log niets • 9 = log bijna alles • hoe hoger, hoe meer impact op performantie • 2 of hoger enkel voor debugging

46. GEDAAN • httpd.apache.org/docs/current/mod/mod_rewrite.html • cheat sheet op AddedBytes.com

mod_rewrite

More Related Content

Featured (20)

mod_rewrite

Editor's Notes