Smarty PHP. Leksykon Kieszonkowy

IDZ DO
PRZYKADOWY ROZDZIA
SPIS TRECI
KATALOG KSIEK
KATALOG ONLINE
Smarty PHP.
Leksykon kieszonkowy
Autor: Daniel Bargie
ISBN: 83-246-0676-9
Format: B6, stron: 112
ZAMW DRUKOWANY KATALOG
TWJ KOSZYK
DODAJ DO KOSZYKA
CENNIK I INFORMACJE
ZAMW INFORMACJE
O NOWOCIACH
ZAMW CENNIK
CZYTELNIA
FRAGMENTY KSIEK ONLINE
Smarty to obiektowa biblioteka dla jzyka PHP suca do tworzenia witryn

internetowych z wykorzystaniem szablonw. Dziki wbudowanemu systemowi
buforowania Smarty jest niezwykle wydajna i szybka, co staje si szczeglnie wane
przy rozbudowanych witrynach WWW. Wykorzystanie biblioteki Smarty pozwala
twrcom witryn i aplikacji WWW znacznie przypieszy prace nad warstw
prezentacyjn i pniejszymi modyfikacjami swoich produktw.
Ksika Smarty PHP. Leksykon kieszonkowy to zestawienie najwaniejszych
informacji dotyczcych tej biblioteki. Znajdziesz w nim wszystko, co moe okaza si
przydatne podczas tworzenia witryny WWW z wykorzystaniem szablonw Smarty.
W kolejnych rozdziaach opisano zagadnienia dotyczce konfigurowania Smarty,
pracy ze zmiennymi, obiektw Smarty oraz obsugi pamici podrcznej.
Komentarze w szablonach
Definiowanie zmiennych
Konfiguracja
Przetwarzanie danych
Metody obiektw klasy Smarty
Funkcje Smarty
Korzystanie z mechanizmu buforowania
Jeli korzystasz z szablonw Smarty, ta ksika powinna znale si w Twojej bibliotece
Wydawnictwo Helion
ul. Kociuszki 1c
44-100 Gliwice
tel. 032 230 98 63
e-mail: helion@helion.pl
Spis treci
1. Podstawy ....................................................................................... 5
Renderowanie szablonu
Komentarze w szablonach
Zmienne szablonw Smarty
Stae
5
8
9
13
2. Waciwoci konfiguracyjne systemu Smarty ...........................14

Kompilacja
Debuger
Pami podrczna
14
17
20
3. Modyfikatory zmiennych Smarty .............................................. 24

Modyfikatory podstawowe
Kombinacja modyfikatorw
24
39
4. Metody obiektw klasy Smarty ..................................................41

Operacje na zmiennych
Obsuga szablonw TPL
Zgaszanie bdw metoda trigger_error()
Obsuga plikw konfiguracyjnych
41
47
50
51
5. Funkcje Smarty ............................................................................ 53

Funkcje iteracyjne
Funkcje warunkowe if
Funkcje doczajce
Funkcje HTML i Mail
Pozostae funkcje
53
62
63
68
77
3
6. Rozszerzenia systemu szablonw ............................................. 88

Nazewnictwo rozszerze
Funkcje szablonw
Funkcje blokowe szablonw
Modyfikatory
88
90
92
95
7. Obsuga pamici podrcznej .......................................................97

Wczanie obsugi pamici podrcznej
Testowanie kopii szablonu w pamici podrcznej
Tworzenie wielu kopii dla jednego szablonu TPL
Usuwanie kopii szablonu z pamici podrcznej
Kontrolowanie rozszerze Smarty
97
98
100
101
104
Skorowidz ..................................................................................105
Spis treci
Rozdzia 4. Metody obiektw klasy Smarty

Obiekty klasy Smarty posiadaj szereg metod, dziki ktrym
mona wykonywa okrelone operacje dotyczce zmiennych,
szablonw czy te plikw konfiguracyjnych.
Operacje na zmiennych
Metoda append() oraz append_by_ref()
Metoda append() (definicja 4.1) umoliwia dodanie nowej wartoci do zmiennej Smarty. Metoda dodaje now zmienn, tworzc
jej kopi.
Definicja 4.1. Metoda append()
void append(string nazwa_zmiennej, mixed wartosc_zmiennej
[, bool polaczenie])
Metoda przyjmuje nastpujce parametry:

nazwa_zmiennej (wymagany) nazwa zmiennej, do ktrej
ma zosta przypisana warto. Jeeli nowa warto jest
dodawana do zmiennej typu string, to nastpuje konwersja
zmiennej string na tablic, a nastpnie dodanie do niej
kolejnego elementu;
wartosc_zmiennej (wymagany) warto zmiennej, ktra
zostanie dodana do zmiennej istniejcej;
polaczenie jeeli parametr bdzie mia warto true,
wartosc_zmiennej zostanie poczona z aktualn zmienn
nazwa_zmiennej. W przeciwnym wypadku nowa warto
zostanie doczona.
D:\Dane\Druk\Smarty PHP. Leksykon kieszonkowy\06_druk\sklad.doc
08 wrz 06
41
41
Na listingu 4.1 zosta przedstawiony przykad wykorzystania

metody append().
Listing 4.1. Przykad wykorzystania metody append()
[Skrypt PHP]
<?php
...
$smarty_obj->append(array('zmienna_1'=>'zmienna 1a',
'zmienna_2'=>'zmienna 2a'));
$smarty_obj->append('zmienna_1', 'zmienna 1b');
...
?>
[Szablon TPL]
{$zmienna_1[1]}
[Wynik wykonania skompilowanego szablonu TPL]
zmienna 1b
Metoda append_by_ref() (definicja 4.2) w dziaaniu jest podobna

do metody append() z t rnic, e warto przekazywana jest
przez referencj, a nie przez warto, jak w przypadku metody
append().
Definicja 4.2. Metoda append_by_ref()
void append_by_ref(string nazwa_zmiennej, mixed
wartosc_zmiennej [, bool polaczenie])

metody append_by_ref().
Listing 4.2. Przykad wykorzystania metody append_by_ref()
[Skrypt PHP]
<?php
...
$wartosc = 'Zmienna 1b';
$smarty_obj->append(array('zmienna_1'=>'zmienna 1a'));
$smarty_obj->append('zmienna_1', $wartosc);
$smarty_obj->append_by_ref('zmienna_1', $wartosc);
$wartosc = 'Zmienna 1c';
...
?>
42
42
Smarty PHP. Leksykon kieszonkowy
08 wrz 06
[Szablon TPL]
{$zmienna_1[0]}
{$zmienna_1[1]}
{$zmienna_1[2]}
zmienna 1a
Zmienna 1b
Zmienna 1c
Metoda assign() oraz assign_by_ref()

Metoda assign() (definicja 4.3) pozwala na utworzenie zmiennej
Smarty dostpnej w szablonie TPL.
Definicja 4.3. Metoda assign()
void assign(array lista_zmiennych)
[lub]
void assign(string nazwa_zmiennej, mixed wartosc_zmiennej)
Jako parametr metody moe zosta uyta tablica asocjacyjna,

w ktrej nazw przyszej zmiennej jest klucz asocjacyjny elementu
tablicy, a jej wartoci warto elementu tablicy (listing 4.3).
Listing 4.3. Tablica asocjacyjna zawierajca list elementw
[Skrypt PHP]
<?php
...
//Przypisanie zmiennych
$smarty_obj->assign(array('zmienna_1'=>'Wartoc zmiennej 1',
'zmienna_2'=>'Wartoc zmiennej 2'));
//Rendering szablonu
$smarty_obj->display('szablon.tpl');
?>
[Szablon TPL]
Warto zmiennej 1 to: {$zmienna_1}
Warto zmiennej 2 to: {$zmienna_2}
Warto zmiennej 1 to: Wartoc zmiennej 1
Warto zmiennej 2 to: Wartoc zmiennej 2
08 wrz 06
43
43
Drugim sposobem przypisania zmiennych do szablonu TPL jest

podanie do metody assign() nastpujcych parametrw:
nazwa_zmiennej (wymagany) nazwa, pod ktr warto
wartosc_zmiennej bdzie dostpna w szablonie TPL;
wartosc_zmiennej (wymagany) warto zmiennej nazwa_
zmiennej dostpna w szablonie TPL.
Na listingu 4.4 zosta przedstawiony kod, ktry przypisuje takie
same zmienne jak kod z listingu 4.3.
Listing 4.4. Inny sposb przypisania zmiennych
<?php
...
//Przypisanie zmiennych Smarty
$smarty_obj->assign('zmienna_1', 'Wartoc zmiennej 1');
$smarty_obj->assign('zmienna_2', 'Wartoc zmiennej 2');
?>
Metoda assign_by_ref() (definicja 4.4) dziaa w sposb podobny do metody assign() z t rnic, e zmienna przypisywana jest przez referencj a nie przez warto.
Definicja 4.4. Metoda assign_by_ref()
void assign_by_ref(string nazwa_zmiennej, mixed
wartosc_zmienej)
Przykad wykorzystania metody assign_by_ref() zosta przedstawiony na listingu 4.5.

Listing 4.5. Przykad wykorzystania metody assign_by_ref()
[Skrypt PHP]
<?php
...
$imie = 'Daniel';
$nazwisko = 'Bargie';
$smarty_obj->assign('imie', $imie);
$smarty_obj->assign_by_ref('nazwisko', $nazwisko);
44
44
08 wrz 06
$imie = 'Ewa';
$nazwisko = 'Gelner';
?>
[Szablon TPL]
Witaj {$imie} {$nazwisko}
Witaj Daniel Gelner
Metoda clear_all_assign() oraz clear_assign()

Metoda clear_all_assign() (definicja 4.5) usuwa wszystkie
zmienne Smarty dostpne w szablonach TPL.
Definicja 4.5. Metoda clear_all_assign()
void clear_all_assign()
Metoda clear_assign() (definicja 4.6) usuwa okrelon zmienn

lub grup zmiennych.
Definicja 4.6. Metoda clear_assign()
void clear_assign(mixed zmienne)
Metoda clear_assign() przyjmuje jeden parametr, ktry zawiera

nazw zmiennej przeznaczonej do usunicia lub tablic zawierajc list nazw zmiennych do usunicia. Przykad wykorzystania metody clear_assign() zosta przedstawiony na listingu 4.6.
Listing 4.6. Przykad wykorzystania metody clear_assign()
<?php
...
// Usunicie pojedynczej zmiennej
$smarty_obj->clear_assign('Name');
// Usunicie listy zmiennych
$smarty_obj->clear_assign(array('Name', 'Address', 'Zip'));
...
?>
08 wrz 06
45
45
Metoda get_template_vars()
Metoda get_template_vars() (definicja 4.7) obiektw klasy Smarty
zwraca tablic zawierajc wszystkie zmienne Smarty.
Definicja 4.7. Metoda get_template_vars()
array get_template_vars([string nazwa_zmiennej])
Jeeli zostanie podany opcjonalny parametr nazwa_zmiennej,

metoda get_template_vars() zwrci warto wybranej zmiennej.
W przeciwnym wypadku zostanie zwrcona tablica asocjacyjna,
zawierajca warto wszystkich zmiennych Smarty. Przykad wykorzystania metody get_template_vars() zosta przedstawiony
na listingu 4.7.
Listing 4.7. Przykad wykorzystania metody get_template_vars()
[Skrypt PHP]
<?php
...
$imie = 'Daniel';
$nazwisko = 'Bargie';
$smarty_obj->assign('imie', $imie);
$smarty_obj->assign('nazwisko', $nazwisko);
var_dump($smarty_obj->get_template_vars('imie'));
var_dump($smarty_obj->get_template_vars());
?>
[Wynik wykonania skryptu PHP]
string(6) "Daniel"
array(3) {
["SCRIPT_NAME"]=>
string(10) "/index.php"
["imie"]=>
&string(6) "Daniel"
["nazwisko"]=>
string(7) "Bargie"
}
46
46
08 wrz 06
Obsuga szablonw TPL

Obiekty klasy Smarty maj dwie metody, dziki ktrym mona
zrenderowa szablon TPL. Pierwsza z nich to metoda display()
(definicja 4.8), ktra wysya tre zrenderowanego szablonu do
bufora wyjciowego. Metoda fetch() (definicja 4.9) zwraca warto typu string zawierajc tre zrenderowanego szablonu TPL.
Metoda display()
Metoda display() (definicja 4.8) wywietla zrenderowany szablon
(wysya jego tre do bufora wyjciowego)
Definicja 4.8. Metoda display()
void display(string nazwa_szablonu [, string
identyfikator_cache [,string identyfikator_kompilacji]])

nazwa_szablonu (wymagany) cieka dostpu do szablonu TPL, ktry ma zosta wywietlony;
identyfikator_cache parametr opcjonalny, pozwalajcy
na okrelenie identyfikatora kopii szablonu w pamici podrcznej. Wicej informacji na ten temat w rozdziale Obsuga
pamici podrcznej;
identyfikator_kompilacji parametr ten pozwala na
utworzenie kilku skompilowanych wersji jednego szablonu
TPL. Moe to by przydatne np. wtedy, gdy szablon powinien by skompilowany oddzielnie dla kadej z wersji
jzykowych obsugiwanych w aplikacji.
Przykad wykorzystania metody display() zosta przedstawiony
na listingu 4.8.
08 wrz 06
47
47
Listing 4.8. Przykad wykorzystania metody display()

<?php
...
// cieka absolutna
$smarty->display('/usr/local/include/templates/header.tpl');
$smarty->display('file:/usr/local/include/templates/
header.tpl');
// cieka absolutna w systemie Windows
$smarty->display('file:c:/www/pub/templates/header.tpl');
// adowanie szablonu z zasobu o nazwie db
$smarty->display('db:header.tpl');
?>
Metoda fetch()
Metoda fetch() (definicja 4.9) obiektw klasy Smarty dziaa bardzo podobnie do metody display(), z tym e nie wysya zrenderowanego szablonu do bufora wyjciowego, lecz zwraca go
w postaci acucha tekstowego.
Definicja 4.9. Metoda fetch()
string fetch(string nazwa_szablonu[, string
identyfikator_cache [, string identyfikator kompilacji]])
Znaczenie parametrw metody fetch() jest identyczne jak

w przypadku metody display() (definicja 4.8).
metody fetch() obiektu klasy Smarty.
Listing 4.9. Przykad wykorzystania metody fetch()
<?php
...
echo $smarty_obj->fetch('szablon.tpl');
?>
48
48
08 wrz 06
Metoda template_exists()
Metoda template_exists() (definicja 4.10) sprawdza, czy okrelony szablon TPL istnieje.
Definicja 4.10. Metoda template_exists()
bool template_exists(string nazwa_szablonu)
Jeeli szablon nazwa_szablonu istnieje, metoda zwraca warto

true. W przeciwnym wypadku zwracana jest warto false.
Przykad wykorzystania metody template_exists() zosta przedstawiony na listingu 4.10.
Listing 4.10. Przykad wykorzystania metody template_exists()
<?php
...
$szablon_tpl = basename($_GET['strona']).'.tpl';
if ($smarty_obj->template_exists($szablon_tpl)) {
$smarty_obj->display($szablon_tpl);
} else $smarty_obj->display('strona_nie_istnieje.tpl');
?>
Metoda clear_compiled_tpl()
Metoda clear_compiled_tpl() (definicja 4.11) czyci skompilowan wersj szablonu TPL lub cay katalog kompilacji.
Definicja 4.11. Metoda clear_compiled_tpl()
void clear_compiled_tpl([string nazwa_szablonu [, string
identyfikator_kompilacji [, int czas_zycia]]])

nazwa_szablonu nazwa pliku szablonu TPL, ktrego
skompilowana kopia powinna zosta usunita;
identyfikator_kompilacji podanie identyfikatora kompilacji spowoduje, e zostan usunite tylko te kopie szablonu TPL, ktre posiadaj okrelony identyfikator kompilacji;
08 wrz 06
49
49
czas_zycia podanie czasu ycia skompilowanych kopii

szablonw TPL spowoduje, e metoda clear_compiled_tpl()
usunie tylko te kopie, ktre s starsze ni podany czas ycia.
Na listingu 4.11 zosta podany przykad wykorzystania metody
clear_compiled_tpl().
Listing 4.11. Przykad wykorzystania metody clear_compiled_tpl()

<?php
...
//Usunicie wszystkich kopii kompilacji szablonu TPL
$smarty_obj->clear_compiled_tpl('szablon.tpl');
//Wyczyszczenie caego katalogu kompilacji
$smarty_obj->clear_compiled_tpl();
?>
Zgaszanie bdw metoda trigger_error()

Metoda trigger_error() (definicja 4.12) umoliwia zgoszenie
bdu przez obiekt klasy Smarty. Metoda ta jest najczciej wykorzystywana w kodzie funkcji rozszerzajcych moliwoci Smarty
(patrz rozdzia Rozszerzenia systemu szablonw).
Definicja 4.12. Metoda trigger_error()
void trigger_error(string tresc_bledu [, int poziom_bledu])

tresc_bledu (wymagany) komunikat bdu;
poziom_bledu moliwe poziomy bdu s takie same
jak dla funkcji PHP trigger_error(). Domyln wartoci
parametru jest E_USER_WARNING.
Przykad wykorzystania metody trigger_error() zosta przedstawiony na listingu 4.12.
50
50
08 wrz 06
Listing 4.12. Przykad wykorzystania metody trigger_error()

[Skrypt PHP]
<?php
...
$smarty_obj->trigger_error('Zgaszam bd obiektu klasy
Smarty', E_USER_WARNING);
?>
[Wynik wykonania skryptu PHP]
Warning: Smarty error: Zgaszam bd obiektu klasy
Smarty in c:\document_root\helion_smarty\smarty\
Smarty.class.php on line 1095
Obsuga plikw konfiguracyjnych

Pliki zawierajce zmienne konfiguracyjne Smarty mog by obsugiwane z poziomu kodu PHP oraz szablonw TPL.
Metoda config_load()
Metoda config_load() (definicja 4.13) obiektu klasy Smarty aduje plik konfiguracyjny i przypisuje zawarte w nim zmienne
do szablonw.
Definicja 4.13. Metoda config_load()
void config_load(string nazwa_pliku [, string nazwa_sekcji])

nazwa_pliku (wymagany) nazwa pliku konfiguracyjnego,
ktry ma zosta zaadowany;
nazwa_sekcji nazwa sekcji w pliku konfiguracyjnym,
z ktrego powinny zosta zaadowane zmienne.
Dziaanie metody jest identyczne z dziaaniem funkcji config_load
(patrz rozdzia Funkcje Smarty), przy czym zaadowane zmienne
zawsze posiadaj zasig globalny, czyli s dostpne w kadym
szablonie TPL.
08 wrz 06
51
51
Metoda clear_config()
Metoda clear_config() (definicja 4.14) usuwa z szablonw przypisane zmienne konfiguracyjne.
Definicja 4.14. Metoda clear_config()
void clear_config([string nazwa_zmiennej])
Jeeli podany zostanie opcjonalny parametr nazwa_zmiennej,

metoda usunie tylko podan zmienn.
Metoda get_config_vars()
Metoda get_config_vars() (definicja 4.15) zwraca list zmiennych konfiguracyjnych przypisanych do szablonu TPL.
Definicja 4.15. Metoda get_config_vars()
array get_config_vars([string nazwa_zmiennej])
Jeeli podany zostanie opcjonalny parametr nazwa_zmiennej,

metoda zwrci jedynie warto podanej zmiennej.
52
52
08 wrz 06

Smarty PHP. Leksykon Kieszonkowy

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Smarty PHP. Leksykon Kieszonkowy

Uploaded by

Copyright:

Available Formats

IDZ DO

ZAMW DRUKOWANY KATALOG

Smarty to obiektowa biblioteka dla jzyka PHP suca do tworzenia witryn

2. Waciwoci konfiguracyjne systemu Smarty ...........................14

3. Modyfikatory zmiennych Smarty .............................................. 24

4. Metody obiektw klasy Smarty ..................................................41

5. Funkcje Smarty ............................................................................ 53

6. Rozszerzenia systemu szablonw ............................................. 88

7. Obsuga pamici podrcznej .......................................................97

Rozdzia 4. Metody obiektw klasy Smarty

Metoda przyjmuje nastpujce parametry:

Rozdzia 4. Metody obiektw klasy Smarty

D:\Dane\Druk\Smarty PHP. Leksykon kieszonkowy\06_druk\sklad.doc

Na listingu 4.1 zosta przedstawiony przykad wykorzystania

Metoda append_by_ref() (definicja 4.2) w dziaaniu jest podobna

Na listingu 4.2 zosta przedstawiony przykad wykorzystania