Problém nastal v případě, kdy měli méně zkušení uživatelé tendence psát hromady zbytečně krkolomných pravidel nebo se je snažili nasadit na nevhodně navrženou strukturu url adres - namísto toho, aby začali s úpravami v PHP kódu. Sám jsem takovým uživatelem býval, ale dnes už vím, jaká je v jednoduchosti síla. Dnešní pokračování seriálu o mod_rewrite tedy vše zase zjednoduší. Představíme si 5 základních využití mod_rewrite, které vám vystačí téměř na jakkoli náročný projekt.

1. Obecné přesměrování

Zapsat do souboru .htaccess přesměrování je jedna z věcí, kterou potřebuje každý. Následující 3 případy by měly pokrýt většinu případů, kdy budeme přesměrování potřebovat:

1. Přesouváme celý web na novou doménu.
2. Změnila se url článků a nemáme v PHP naprogramovaný modul, který by redirectoval automaticky.
3. Změnila se url kategorie a je potřeba přesměrovat i vše, co je uvnitř.

# celý web na novou doménu
RewriteRule ^(.*)$ http://www.nova-domena.cz/$1 [L,R=301,QSA]

# konkrétní url na jinou konkrétní url
RewriteRule ^clanek/?$ jiny-clanek/ [L,R=301]

# stará kategorie a vše uvnitř na novou kategorii
RewriteRule ^stara-kategorie/(.*)$ nova-kategorie/$1 [L,R=301]

2. Přidání nebo umazání www před doménovým jménem

Pro domény druhého řádu chceme www přidávat, u domén třetího řádu zase odmazávat. Toto by mělo být zpravidla vyřešeno už na úrovni hostingu, ale ne vždy tomu tak bývá. Proto druhý typ přepisů, které člověk využije, je právě přidávání respektive umazávání "www".

# umazání www
RewriteCond %{HTTP_HOST} ^www.mujweb.cz$
RewriteRule (.*) http://mujweb.cz/$1 [R=301,QSA,L]

# přidání www
RewriteCond %{HTTP_HOST} ^mujweb.cz$
RewriteRule (.*) http://www.mujweb.cz/$1 [R=301,QSA,L]

3. Hezké url pro jednoduchý web

Pokud máme vytvořený jednoduchý web, který využívá include podle GET proměnné nebo je vše rozházeno v souborech *.php v kořenovém adresáři webu, bude vždy stačit jedno z následujících pravidel. Víc opravdu není nutné. Jakmile začneme mít potřebu složitějších rewritů, máme tu už jedno obecné pravidlo, které vystačí jak na miniaturní webík tak na monstrózní aplikaci.

# index.php?page=neco => neco/
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?page=$1 [L]

# stranka.php => stranka/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)/$ $1.php [L]

4. Hezké url pro web libovolné náročnosti

Všechno na index.php. Víc není potřeba. Bude existovat jedna GET proměnná, kterou rozbijeme podle lomítka a necháme už PHP, aby si zpracovalo řetězec podle své potřeby. Ve chvíli, kdy pocítíme potřebu dalších GET proměnných, rewritovat je už nebudeme, protože to prostě není potřeba. Jestl i tak máme stále nutkání tyto proměnné rewritovat, bude možná lepší se nejdřív zamyslet nad architekturou aplikace.

# vše na index.php a proměnnou $_GET[path]
RewriteCond %{REQUEST_FILENAME} !-d 
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?path=$1 [L,QSA]

5. Výjimka z předchozího příkladu

Zase tak jednoduché to nakonec nebude, abychom všechno pokryli jedním pravidlem :o) Občas potřebujeme určité url adresy nasměrovat na jiný soubor, než index.php: například proto, aby se zbytečně nenačítalo celé jádro systému a všechny knihovny, když chceme udělat jenom jednoduchý AJAX request. Nebo nabídnout soubor ke stažení tak, aby nebyla vidět ani url souboru ani skutečná url skriptu, který soubor ke stažení nabídne. Přidáme tedy pravidlo druhé, které musí být uvedeno před tím prvním: pokud regulární výraz nebude splněn, server aplikuje pravidlo druhé.

RewriteCond %{REQUEST_FILENAME} !-d 
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^simple_module/(.*)?$ index_simple.php?path=$1 [L,QSA]

RewriteCond %{REQUEST_FILENAME} !-d 
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?path=$1 [L,QSA]

6. HTTP na HTTPS

SSL certifikát je dnes už téměř samozřejmostí a občas potřebujeme na celé doméně přidat to "s" do protokolu. To nám umožní následující zápis.

RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://www.treba.cz/$1 [R=301,L]

Čtvrtý bod bych měl ještě asi trochu více rozvést. Kdykoli bude výsledná url stránky například "www.treba.cz/hlavni-kategorie/dalsi-kategorie/", proměnná $_GET["path"] bude mít hodnotu "hlavni-kategorie/dalsi-kategorie/". Proměnnou rozbijeme podle lomítka (funkcí explode) a šáhneme do databáze pro "Další kategorii" která má nad sebou "Hlavní kategorii". Tedy namísto vícenásobných identifikátorů pro strukturu stránek pracujeme s polem hodnot.

Jestliže chceme přidat ještě i nějaké stránkování (které mimochodem opravdu nemusí mít "pěkné" url), stačí otestovat poslední hodnotu pole na celé číslo. Tím rozlišíme, že "hlavni-kategorie/2/" je pouze druhá stránka výpisu příspěvků, nikoli kategorie "2". Problém samozřejmě nastane ve chvíli, kdy budeme kategorii pojmenovanou "2" vlastně chtít: a jedno nám přebije druhé.

A to je vše dámy a pánové. V předchozích dílech seriálu jsem vás naučil, jak mod_rewrite funguje, co všechno dokáže a jak specifická pravidla umožňuje napsat. A díky tomu jsem dnes mohl ukázat, že dané vědomosti je dobré mít, ale v praxi je vždy využijeme na mnohem jednodušší úrovni.

Například jsem se často setkal s věčným opakováním RewriteEngine On a RewriteBase před každám pravidlem: ne, není nutné to stále opakovat. Co ale musí být u každé další proměnné uvedeno, je RewriteCond. Podmínka RewriteCond testuje, zda-li soubor či adresář daného jména neexistuje. (! negace, - parametr, d=dir - složka, f=file - soubor)

# mujweb.cz/?page=neco > mujweb.cz/neco/

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^([^/]+)/?$ ?page=$1

Když se tedy znovu podíváme na základní příklad z prvního dílu: RewriteEngine On - zapneme mod_rewrite. RewriteBase - budeme vycházet z kořenového adresáře. RewriteCond - podmínka, otestujeme možnou existenci souboru či adresáře se stejným jménem. REQUEST_FILENAME je speciální proměnná právě pro modul mod_rewrite. No a RewriteRule je pouze regulární výraz, první v pořadí je výsledná url, druhý výraz je skutečná url, kterou budeme podstrkávat.

Nejčastější problémy při použití mod_rewrite jsou dva: nefungují styly, nenačtou se obrázky. K vyřešení můžeme použít element <base>, nebo absolutní odkazy. Jak celé i s http, tak pouze absolutní cesty v rámci vlastního webu začínající lomítkem. Pokud ani jedno nepomůže, problém hledejte v samotném .htaccessu. Pokud zapomenete otestovat možnost existence souboru / složky, styly a obrázky se Vám nemusí vůbec načíst.

Jestli si myslíte, že musíte používat adresy ve tvaru /?page=neco abyste nebyli ochuzeni o pěknou adresářovou strukturu, tak Vás rád vyvedu z omylu: pomocí následujícího přepisu můžeme podstrčit pěknou url i souborům s koncovkou *.php:

# clanek.php => /clanek/

RewriteEngine On
RewriteBase /

RewriteCond %{ENV:REDIRECT_STATUS} !^$
RewriteRule .* - [L]

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)/$ $1.php [L]

RewriteCond %{REQUEST_URI} !.[[:alnum:]]+$
RewriteRule ^(.+[^/])$ /$1/ [R=301] 

Tento přepis ale není příliš propracovaný: pokud zadáme adresu bez lomítka, vyskočí chyba 404. To vyřešíme velice snadno přidáním posledních dvou řádků, které automaticky doplní lomítko na konec adresy. Při zadání adresy bez lomítka proběhne přesměrování na správnou url, kde už se načte požadovaný soubor. Pokud samotný soubor pracuje dále s proměnnými, adresy mohou vypadat následovně: /clanek.php?id=20 > /clanek/?id=20

A že je vždy potřeba dynamických stránek pro mod_rewrite? Výše uvedené lze použít i u obyčejných statických stránek s příponou *.html. Stačí změnit jeden řádek:

# soubor.html => /soubor/

RewriteEngine On
RewriteBase /

RewriteCond %{ENV:REDIRECT_STATUS} !^$
RewriteRule .* - [L]

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)/$ $1.html [L]

RewriteCond %{REQUEST_URI} !.[[:alnum:]]+$
RewriteRule ^(.+[^/])$ /$1/ [R=301]

Automatické přidání lomítka na konec adresy pak můžeme použít i samostatně: (doporučuji)

RewriteCond %{REQUEST_URI} !.[[:alnum:]]+$
RewriteRule ^(.+[^/])$ /$1/ [R=301]

Na závěr se ještě podíváme na příznaky. To jsou ta písmenka v závorce za každým z pravidel:

Příznaky (flags)

V některých přepisech je nutné použít takzvané příznaky (flags), které mají různé významy. Uvedu zde nejpoužívanější: 

V tomto článku nebudu popisovat žádný návod na práci se souborem .htaccess, ale nabídnu Vám již hotová řešení, které jsem sám zkoušel, sám je také používám, takže jejich funkčnost je ověřená. Jediný problém, který může nastat je nedostatečná podpora mod_rewrite hostingu. Již dopředu raději upozorním, že např. na IC.cz s těmito přepisy moc nepochodíte.

Jako první bych uvedl základní přesměrování, na verzi adresy s nebo bez www:
http://www.mujweb.cz » http://mujweb.cz

# www > bez www
RewriteEngine On
Options +FollowSymlinks
RewriteCond %{HTTP_HOST} ^www.mujweb.cz$
RewriteRule (.*) http://mujweb.cz/$1 [R=301,QSA,L]

# verze bez www > s www
RewriteEngine On
Options +FollowSymlinks
RewriteCond %{HTTP_HOST} ^mujweb.cz$
RewriteRule (.*) http://www.mujweb.cz/$1 [R=301,QSA,L]

Je pouze na Vás, pro kterou verzi se rozhodnete - ale je dobré si jednu zvolit. Pro Google jsou to totiž 2 rozdílné adresy a všechny zpětné odkazy by se Vám dělily.

Jako druhý přepis uvedu přesměrování ze subdomény na doménu. Pokud máte web např. na některém z freehostingů, tak cokoli.mujweb.wz.cz == mujweb.wz.cz. Problém je akorát v tom, pokud to "cokoli" do adresy zadáme, tak to tam také zůstane. Stačí vložit následující řádky do souboru .htaccess, a při zadání adresy jakékoli neexistující subdomény na Vašem webu proběhne přesměrování na Vaši hlavní stránku.

# subdoména > doména (cokoli.mujweb.cz > mujweb.cz)
RewriteEngine On
RewriteBase /
Options +FollowSymlinks
RewriteCond %{HTTP_HOST} ^(.*).mujweb.cz
RewriteRule (.*) http://mujweb.cz/$1 [R=301,QSA]

Tohle přesměrování samozřejmě nepoužívejte v případě, že máte v .htaccessu vytvořenou subdoménu (tzn. doménu 3. řádu na placeném a doménu 4. řádu na freehostingu)

Subdoména se dá vytvořit následujícím zápisem... Dejme tomu, že máme na webu fotogalerii, a chceme pro ni vytvořit vlastní subdoménu. V kořenovém adresáři vytvoříme složku např. foto, kterou pak pomocí mod_rewrite převedeme na doménu 3. respektive 4. řádu. Pokud tak učiníme, musíme ale počítat s možnými problémy - přepisem vlastně složku povýšíme na úroveň kořenového adresáře, takže:

1. přestanou fungovat relativní HTML odkazy
2. přestane fungovat relativní includování
3. .htaccess v rootu přestane mít na naši subdoménu vliv
4. některé další přepisy tu nebudou fungovat

# subdoména foto.mujweb.cz
RewriteEngine On
RewriteBase /
RewriteCond %{HTTP_HOST} foto.mujweb.cz
RewriteCond %{REQUEST_URI} !foto/
RewriteRule ^(.*)$ foto/$1

V tuto chvíli nám budou fungovat obě adresy: http://mujweb.cz/foto a http://foto.mujweb.cz. Vy už se musíte postarat o to, aby všechny zpětné odkazy vedly na tu správnou adresu, a vyhledávače indexovali jen to, co chceme my.

Takže subdoménu už jsme vytvořili, ale jde to i zpět? Pokud už Vám ji vyhledávače zaindexovaly, a vy se chcete vrátit zpět k adrese se složkou za lomítkem, stačí použít tento přepis:

 # subdoména > doména/složka
RewriteEngine On
RewriteBase /
Options +FollowSymlinks
RewriteCond %{HTTP_HOST} ^slozka.mujweb.cz
RewriteRule (.*) http://mujweb.cz/slozka/$1 [R=301,QSA,L]

A na závěr už se konečně pustíme do těch "cool uris". V prvé řadě je ale nutné si ujasnit, jak je vlastně budeme používat: pokud se jedná pouze o klasické includování podle podmínky, není problém. Horší je to např. u výpisu z adresáři... Jelikož nám Cool uris udělají z každého souboru pomyslný adresář, musí samozřejmě platit, že ten adresář neexistuje. Pokud máme např. fotogalerii postavenou na výpisu souborů ze složky, mohli bychom si vystačit s něčím takovým: mujweb.cz/?page=prazdniny » mujweb.cz/prazdniny.html. Tento přepis se dá použít i u klasického includování, a navíc návštěvníkům vytvoří krásnou iluzi statického webu. Lze použít i jiné koncovky, které prohlížeče znají: *.php, *.php3, *.htm, *.asp, *.cgi ... a jiné.

# mujweb.cz/?promenna=neco > mujweb.cz/neco.html
RewriteEngine On
RewriteRule ^(.*).html /?promenna=$1

Nebo jiný zápis, s podobným efektem: (změna je v přidání query stringu a v omezení regulárním výrazem)

RewriteRule ^([A-Za-z0-9-]+).(html)?$ /?promenna=$1 [L,QSA]

Další přepis, který je poměrně nutný při zavádění "hezkých url" je následující: potřebujeme se zbavit indexu.php v adrese. Takže potřebujeme přesměrování, které při zadání http://mujweb.cz/index.php návštěvníka přesměruje na http://mujweb.cz/ To samé lze použít i pro index.htm či index.html...

# mujweb.cz/index.php > mujweb.cz/
RewriteEngine On
RewriteRule ^index.php$ http://mujweb.cz/$1 [R=301]

A teď už ty dlouho očekávaní Cool uris =o) Uvádím 3 funkční verze, jednu z nich pro jednu i dvě proměnné. Jestli na konci lomítko bude nebo ne, už určíte Vy tvarem html odkazů. Ty by měly vypadat nějak takto: a href="/neco/"

# mujweb.cz/?page=neco > mujweb.cz/neco/
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^([^/]+)/?$ ?page=$1

Pro dvě proměnné stačí k výše uvedenému přepisu přidat následující řádky:

# mujweb.cz/?page=neco&stranka=druha > mujweb.cz/neco/druha
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^([^/]+)/([^/]+)?/?$ ?page=$1&stranka=$2

Alternativní možnost pro jednu proměnnou:

# mujweb.cz/?page=neco > mujweb.cz/neco/ (jiná možnost)
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /?page=$1 [L]

A třetí možnost zápisu pro jednu proměnnou:

# mujweb.cz/?page=neco > mujweb.cz/neco/ (zase jiná možnost)
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^([A-Za-z0-9-\_]+)/?$ ?page=$1 [L]

Cool uris nám udělají z každého souboru adresář: takže se opět může stát, že některé HTML odkazy přestanou fungovat: v takovém případě stačí každý   a href="/index.php", link href="/style.css", img src="/obrazky/picture.jpg" začít lomítkem. Nezapomeňte také na to, že při přepisu pro více proměnných musíte uvést samostatně přepis pro proměnnou každého řádu.

To by bylo tak asi vše, užívejte si své hezké url. Zasloužíte si je ;-)