Tekst źródłowy strony Wyrażenia regularne w argumentach parametrów

'''Wyrażenia regularne w argumentach parametrów''' -  Joomla! {{j_15}} {{j_16}} {{J_17}}

Niektóre argumenty parametrów mogą posiadać, jako wartość, wyrażenie regularne. Na przykład, argumenty '''filter''' i '''exclude''' dla typów parametrów  '''filelist''' i '''imagelist'''. Jest to niezwykle przydatne, ale wymaga większej wiedzy na temat składni wyrażeń regularnych, aby móc używać ich efektywnie.

Opisano tu przykłady prostych wyrażeń regularnych, które można używać w kontekście parametrów szablonu. Pełne odniesienie do składni wyrażeń regularnych wykracza poza zakres tej wiki, ale można znaleźć w Internecie [http://www.php.net/manual/en/book.pcre.php więcej informacji] na ten temat.

=== Prosty filtr ciągu ===
Załóżmy, że chcesz użyć parametru typu '''filelist''', aby wyświetlić listę plików w danym katalogu. Istnieje wiele plików w katalogu, ale chcesz by wymienione były tylko te z rozszerzeniem '.php'. Następnie należy użyć tego argumentu w elemencie <tt><param></tt>

<source lang="xml">
filter = “\.php”
</source>

Pierwszą rzeczą, na  którą trzeba zwrócić uwagę jest wiodący znak backslash. Jest to konieczne, ponieważ znak "." ma specjalne znaczenie w wyrażeniach regularnych. Znak backslasha powoduje że pierwszy znak za nim traktowany jest dokładnie takim jakim jest, co da nam zwykłą kropkę ".".

Efektem zastosowania tego filtru, będą tylko te pliki, które w dowolnym miejscu swojej nazwy, posiadają te znaki w takiej kolejności występowania “.”, “p”, “h”, “p”

=== Mocowanie do końca łańcucha ===
Jeśli zastosujemy filtr z poprzedniego przypisu, to mając plik o nazwie ''configuration.php-dist'' - zostałby on zaakceptowany, gdyż znajduje się w nim ciąg “.php” w środku łańcucha. Jeśli naszym zamiarem było uzyskanie tylko plików kończących się na ".php" powinniśmy zastosować filtr:
<source lang="xml">
filter = “\.php$”
</source>

Znak "$" (dolar) w wyrazeniu regularnym odpowiada za to, że szukany ciąg musi znajdować się na końcu łańcucha. Dzięki temu plik ''configuration.php'' zostanie zaakceptowany, a ''configuration.php-dist'' już nie.

=== Mocowanie do początku łańcucha ===
Jeśli chcesz by wybrane zostały tylko te plik, które zaczynają się od słowa "joomla", filtr powinien wyglądać tak:
<source lang="xml">
filter = “^joomla”
</source>

Znak “^” w wyrażeniach regularnych odpowiada za to, by poszukiwane wyrażenie zaczynało się dokładnie na początku przeszukiwanego łańcucha.

=== Mocowanie na obu końcach łańcucha ===
Jeśli chciałbyś wyświetlić wszystkie pliki zaczynające się od słowa “joomla” i kończące się na “.php”, nie dbając o to co znajduje się pomiędzy nimi, to filtr powinien wyglądać tak:
<source lang="xml">
filter = “^joomla(.*)\.php$”
</source>

Znak "^" powoduje poszukiwanie na początku łańcucha słowa "joomla", a znak "$" powoduje że poszukiwany ciąg ma kończyć się na ".php".
Dodatkowo w środku znajduje się "(.*)" co oznacza że pomiędzy końcem a początkiem wyszukiwanego ciągu może znajdować się dowolny pojedynczy znak (to ta "."), i może on występować dowolną ilość razy, w tym nawet zero razy (to ta "*"). Nawiasy służą do oddzielenia tego ciągu od reszty poszukiwanych fraz.

=== Rozróżnianie wielkości liter ===
Należy pamiętać że wyrażenia regularne rozróżniają wielkości liter. Stosując poprzednie przykłady, możemy natrafić na pliki zaczynające się zarówno od "Joomla" jaki i "joomla". Niestety te z "Joomla" nie zostaną załadowane. Aby temu zaradzić należy zastosować taki filtr:
<source lang="xml">
filter = “^[Jj]oomla”
</source>

Dzięki zapisowi "[Jj]" zostaną dopasowane słowa "Joomla" i "joomla". Nawiasy kwadratowe “[]” wskazują nam '''klasę znaków''' i powinny zawierać wszystkie znaki jakie chcemy dopasować. Na przykład jeśli poszukiwany ciąg miałby dopasować te litery  “s”, “t”, “u” or “v”  należałoby zapisać to tak:
<source lang="xml">
filter = “^[stuv]oomla”

czyli pasowałyby : soomla, toomla, uoomla, voomla
</source>

lub tak (bo są one ułożone kolejno w alfabecie):
<source lang="xml">
filter = “^[s-v]oomla”

czyli pasowałyby : soomla, toomla, uoomla, voomla
</source>

lub tak, jeśli miały by to być i małe i duże litery:
<source lang="xml">
filter = “^[s-vS-V]oomla”

czyli pasowałyby : soomla, toomla, uoomla, voomla, Soomla, Toomla, Uoomla, Voomla
</source>

=== Filtrowanie listy rozszerzeń ===
Jeśli chcesz filtrować pliki w zależności od rozszerzenia danego pliku, i jeśli to ma być tylko jedno rozszerzenie, powinieneś zastosować taki filtr:
<source lang="xml">
filter = “\.php$”
</source>
Ale co, gdy chcesz kilka rodzajów rozszerzeń, np. “.php”, “.html” i “.txt” ? Należy to zrobić tak:
<source lang="xml">
filter = “\.php$|\.html$|\.txt$”
</source>

Znak "|" powoduje, że dopasowane może być alternatywnie ''to |lub to |lub to''

Można zauważyć że typ parametru '''imagelist''' (oraz podobnie '''filelist''') zawierają właśnie taki filtr
<source lang="xml">
filter = “\.png$|\.gif$|\.jpg$|\.bmp$|\.ico$”
</source>
<noinclude>
=== Zobacz także ===
{{NTP}}
{{NTPF}}
{{NTPL}}
[[Kategoria:Szablony 1.5]]
[[Kategoria:Programiści]]
[[Kategoria:Programowanie]]

</noinclude>