Базовая инсталяция

Инсталируйте библиотечный файлы Smarty, которые анаходятся в папке /libs/ дистрибутива. Вы НЕ ДОЛЖНЫ редактировать эти файлы. Они разделены среди всех приложений и могут изменяться только при обновлении Smarty.

Smarty.class.php
Smarty_Compiler.class.php
Config_File.class.php
debug.tpl
/plugins/*.php (все файлы!)

Smarty использует PHP константу SMARTY_DIR, которая указывает путь к библиотечным файлам Smarty. Обычно, если приложение может найти файл Smarty.class.php , то нет необходимости устанавливать SMARTY_DIR, Иначе, если Smarty.class.php не в вашем include_path, или вы не указывали абсолютный путь к нему в приложении, то вы должны определить SMARTY_DIR вручную. SMARTY_DIR должен включать завершающий слэш.

Как надо создавать обект Smarty в ваших PHP сценариях:

require('Smarty.class.php');
$smarty = new Smarty;

Попробуйте выполнить вышеупомянутый сценарий. Если Вы получаете ошибку о том, что Smarty.class.php не найден, вы должны селать одно из следующего:

require('/usr/local/lib/php/Smarty/Smarty.class.php');
$smarty = new Smarty;

// Отредактируйте ваш php.ini файл, добавьте библиотечный 
// каталог Smarty к include_path и перезаупстите веб сервер.
// Тогда следующее должно работать:
require('Smarty.class.php');
$smarty = new Smarty;

define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
require(SMARTY_DIR.'Smarty.class.php');
$smarty = new Smarty;

Теперь, когда библиотечные файлы находятся на месте, пришло время установка каталоги Smarty для вашего приложения. Smarty требует четыре каталога, которые (по умолчанию) называются templates , templates_c , configs и cache . Каждый из них определяем свойствами класса Smarty $template_dir , $compile_dir , $config_dir , и $cache_dir соответственно. Очень рекомендуется, чтобы вы устанавливали отдельные наборы этих каталогов для каждого приложения, которое будет использовать Smarty.

Убедитесь, что Вы знаете расположение вашего корня документа на веб сервере. В нашем примере, корень документа - "/web/www.mydomain.com/docs/". К каталогам Smarty обращается только библиотека Смарти и никогда не обращает непосредственно web-браузером. Поэтому, чтобы избежать любых предприятий(беспокойств) защиты, рекомендует разместить эти каталоги в каталог от корня документа. Be sure you know the location of your web server document root. In our example, the document root is "/web/www.mydomain.com/docs/". The Smarty directories are only accessed by the Smarty library and never accessed directly by the web browser. Therefore to avoid any security concerns, it is recommended to place these directories in a directory off the document root.

For our installation example, we will be setting up the Smarty environment for a guest book application. We picked an application only for the purpose of a directory naming convention. You can use the same environment for any application, just replace "guestbook" with the name of your app. We'll place our Smarty directories under "/web/www.mydomain.com/smarty/guestbook/".

You will need as least one file under your document root, and that is the script accessed by the web browser. We will call our script "index.php", and place it in a subdirectory under the document root called "/guestbook/". It is convenient to setup the web server so that "index.php" can be identified as the default directory index, so if you access "http://www.mydomain.com/guestbook/", the index.php script will be executed without "index.php" in the URL. In Apache you can set this up by adding "index.php" onto the end of your DirectoryIndex setting (separate each entry with a space.)

Lets take a look at the file structure so far:

/usr/local/lib/php/Smarty/Smarty.class.php
/usr/local/lib/php/Smarty/Smarty_Compiler.class.php
/usr/local/lib/php/Smarty/Config_File.class.php
/usr/local/lib/php/Smarty/debug.tpl
/usr/local/lib/php/Smarty/plugins/*.php

/web/www.mydomain.com/smarty/guestbook/templates/
/web/www.mydomain.com/smarty/guestbook/templates_c/
/web/www.mydomain.com/smarty/guestbook/configs/
/web/www.mydomain.com/smarty/guestbook/cache/

/web/www.mydomain.com/docs/guestbook/index.php

Smarty will need write access to the $compile_dir and $cache_dir , so be sure the web server user can write to them. This is usually user "nobody" and group "nobody". For OS X users, the default is user "www" and group "www". If you are using Apache, you can look in your httpd.conf file (usually in "/usr/local/apache/conf/") to see what user and group are being used.

chown nobody:nobody /web/www.mydomain.com/smarty/guestbook/templates_c/
chmod 770 /web/www.mydomain.com/smarty/guestbook/templates_c/

chown nobody:nobody /web/www.mydomain.com/smarty/guestbook/cache/
chmod 770 /web/www.mydomain.com/smarty/guestbook/cache/

We need to create the index.tpl file that Smarty will load. This will be located in your $template_dir.

{* Smarty *}

Hello, {$name}!

Now lets edit index.php. We'll create an instance of Smarty, assign a template variable and display the index.tpl file. In our example environment, "/usr/local/lib/php/Smarty" is in our include_path. Be sure you do the same, or use absolute paths.

// load Smarty library
require('Smarty.class.php');

$smarty = new Smarty;

$smarty->template_dir = '/web/www.mydomain.com/smarty/guestbook/templates/';
$smarty->compile_dir = '/web/www.mydomain.com/smarty/guestbook/templates_c/';
$smarty->config_dir = '/web/www.mydomain.com/smarty/guestbook/configs/';
$smarty->cache_dir = '/web/www.mydomain.com/smarty/guestbook/cache/';

$smarty->assign('name','Ned');

$smarty->display('index.tpl');

Now load the index.php file from your web browser. You should see "Hello, Ned!"

You have completed the basic setup for Smarty!