[2009–09–24] Route: volitelné sekvence […]

V routovací masce třídy Route lze označovat tzv. volitelné sekvence. Ty se uzavírají do složených hranatých závorek. Ukažme si to na jednoduchém příkladu:

$route = new Route('[<lang [a-z]{2}>/]<name>', array());

Akceptuje cesty:
   /cs/download  => lang=cs, name=download
   /download     => lang=NULL, name=download

Výhodou je, že volitelný parameter se může nacházet i uprostřed masky, ale především lze definovat jeho okolí, v tomto případě znak lomítka, které musí parametr, pokud je uveden, obklopovat. To lze využít například u volitelných subdomén:

$router[] = new Route('//[<module>.]example.com/<presenter>/<action>', array(
    'presenter' => 'Homepage',
    'action' => 'default',
));

Závorky je možné libovolně zanořovat:

$route = new Route('[<lang [a-z]{2}>[-<sublang>]/]<name>[/page-<page>]', array(
        'page' => 0,
));

Akceptuje cesty:
	/cs/stranka
	/en-us/stranka
	/stranka
	/stranka/page-12

Přitom uvnitř volitelné sekvence nemusí být ani žádný parametr:

$route = new Route('index[.html]', array());

Akceptuje cesty:
	/index.html
	/index

Generuje:
	/index

Generování URL

Při generování cest se používá pravidlo nejkratšího URL, takže všechno, co lze vynechat, se vynechá. Právě proto routa index[.html] generuje, jak jsem naznačil výše, cestu index.

Pokud byste naopak chtěli generování volitelné sekvence vynutit, napište za levou závorku vykřičník:

$route = new Route('index[!.html]', array());

Akceptuje cesty:
	/index.html
	/index

Generuje:
	/index.html

Opět lze libovolně kombinovat společně se zanořováním a parametry.

Interní poznámka: volitelné parametry (tj. parametry mající výchozí hodnotu) mimo složených závorek se chovají v podstatě tak, jako by byly uzávorkovány následujícím způsobem:

// tento zápis
$route = new Route('<presenter>/<action>/<id>', array(
	'presenter' => 'Dashboard',
	'action' => 'default',
	'id' => NULL,
));

// odpovídá funkčně tomuto:
$route = new Route('{<presenter>/{<action>/{<id>}}}', array(
	'presenter' => 'Dashboard',
	'action' => 'default',
	// 'id' => NULL, neni potřeba uvádět
));

Pokud byste chtěli ovlivnit chování zpětných lomítek, tj. aby se místo např. dashboard/view/ generovalo dashboard/view, lze toho docílit takto:

$route = new Route('{<presenter>{/<action>{/<id>}}}', array(
	'presenter' => 'Dashboard',
	'action' => 'default',
));

Což ale není z logiky URL-tvorby správné.

Foo-parametery

Ačkoliv možnosti foo-parametrů a volitelných sekvencí se trošku překrývají, navzájem se nenahrazují. Účelem foo-parametrů je dostat do masky regulární výrazy, naopak volitelné sekvence s nimi vůbec nepracují.