CompZone.Org :: Artykuły :: PHP

Smarty - Instalacja

Smarty jest niezwykle rozbudowanym systemem obsługi szablonów w PHP. Pozwala on na wiele więcej niż proste klasy które zastępują zmienne. To także obsługa struktur sterujących oraz wiele więcej.

W tym artykule przedstawię jak zainstalować pakiet oraz na prostym przykładzie pokażę jak działa system smarty.

Instalacja Smarty

Przed użyciem pakietu smarty należy go najpierw zainstalować. Pobieramy pakiet Smarty, możemy go pobrać stąd lub z oficjalnej strony pakietu Smarty (http://smarty.php.net/).

Po rozpakowaniu otrzymujemy sporo plików i katalogów, do działania pakietu niezbędnych jest tylko kilka, są to trzy pliki zawierające klasy:

Smarty.class.php
Smarty_Compile.class.php
Config_File.class.php

oraz katalog:

plugins (wraz z zawartością)

Pliki te umieścić najlepiej w miejscu gdzie PHP automatycznie poszukuje dołączanych plików. Jeśli nie mamy takiej możliwości możemy skopiować te pliki do dowolnego katalogu a następnie w czasie działania skryptu zmodyfikować dyrektywę konfiguracyjną include_path, lub zdefiniować stałą zapisując w niej ścieżkę do katalogu z plikami.

Sposób 1

 <?php
 ini_set('include_path', ini_get('include_path').'.:/home/compzone/smarty/');
 ?>

Sposób 2

 <?php
 define('SMARTY_DIR', '/sciezka/Smarty/');
 ?>

Następnym krokiem instalacji jest utworzenie czterech katalogów, które będą wykorzystywane przez pakiet. Podane poniżej nazwy katalogów można zmieniać, musimy jednak wtedy podać je podczas konfigurowania składowych głównej klasy mechanizmu.

templates - przechowywane są w nim szablony wykorzystywane przez pakiet smarty. Katalog ten powinien znajdować się poza drzewem katalogów.
templates_c - przechowuje skompilowane szablony, które są wykonywane w celu wyświetlenia strony. Katalog ten musi znajdować się w drzewie katalogów witryny WWW oraz musi mieć prawo zapisu plików w tym katalogu.
configs - przechowuje pliki konfiguracyjne wykorzystywane przez pakiet Smarty. Katalog powinien znajdować się poza drzewem katalogów witryny.
cache - pełni funkcję pamięci podręcznej służącej do przechowywania szablonów. Katalog powinien znajdować się poza drzewem katalogów witryny. Zarówno PHP jak i serwer WWW musi mieć prawo zapisu plików w tym katalogu.

Konfiguracja Smarty

Kolejnym krokiem jest skonfugurowanie mechanizmu Smarty. Otwieramy plik Smarty.class.php i modyfikujemy (o ile to konieczne) wartość składowych, ich opis poniżej:

$template_dir - scieżka do katalogu, w którym Smarty będzie poszukiwał szablonów, składowa ta powinna prowadzić do utworzonego wcześniej katalogu (domyślnie templates)
$compile_dir - sciezka do katalogu, w którym Smarty będzie zapisywał skompilowane wersje szablonow (domyślnie templates_c).
$plugins_dir - sciezka do katalogu, w którym Smarty będzie poszukiwać pluginów używanych przez mechanizm Smarty (domyślnie array('plugins')).
$compile_check - wartość ta określa czy Smarty będzie sprawdzać, czy szablon wymaga powtórnej kompilacji (domyślnie true).

Zastosowanie Smarty

Teraz kiedy Smarty jest zainstalowane i skonfigurowane przyszedł czas na prosty przykład pokazujący podstawowe zastosowanie czyli podmianę zmiennych. W tym celu utworzymy dwa pliki:

ex.tpl – testowy szablon, plik należy umieścić w katalogu templates
ex.php – plik z kodem php obsługującym szablon, plik należy umieścić w dowolnym miejscu drzewa witryny.

ex.tpl

 <html>
 <head>
 <title>Smarty z Compzone.Org</title>
 </head>
  
 <body>
 Poniżej powinien wyświetlić się napis: Witaj na Compzone.Org<br />
 {$powitanie}
 <p>A poniżej jakieś przyjemne pożegnanie</p>
 {$pozegnanie}
 </body>
 </html>

ex.php

 <?php
 require('Smarty.class.php'); //dolaczamy plik z klasa
 $smarty = new Smarty; //tworzymy nowy obiekt klasy Smarty
  
 /*Przypisanie zmiennym szablonu ich wartości*/
 $smarty -> assign('powitanie', 'Witaj na Compzone.Org');
 $smarty -> assign('pozegnanie', 'Dziękujemy za odwiedziny i zapraszamy ponownie!');
  
 /*Wywołanie szablonu*/
 $smarty -> display('ex.tpl'); //Wywołujemy szablon do kompilacji
 ?>

Następnie podejmujemy próbę wyświetlenia w przeglądarce pliku ex.php. W rezultacie powinniśmy otrzymać stronę podobną do tej poniżej.


Wykonanie pliku ex.php

Zakończenie

Artykuł ten pokazuje jak poprawnie zainstalować oraz skonfigurować pakiet Smarty, przedstawiony przykład ma na celu sprawdzić poprawność naszej konfiguracji, jeśli występują jakieś problemy, lub zamiast oczekiwanej strony widzimy błędy należy sprawdzić czy zostały stworzone wszystkie katalogi, czy nadano im odpowiednie prawa do zapisu.

jedre @ 03-08-2006 18:49

Brak komentarzy...