Smarty - это компилирующий обработчик шаблонов для PHP и на PHP. Говоря более четко, он предоставляет один из инструментов, которые позволяет добиться отделения прикладной логики и данных от представления. Это очень удобно в ситуациях, когда программист и верстальщик шаблона - различные люди. Например, скажем, вы создаете страницу, которая показывает газетную статью. Название статьи, автор и сама статья - элементы, которые не содержат никакой информации о том, как они будут представлены. Их передают в Smarty из приложения, а верстальщик шаблона редактирует шаблоны и использует комбинацию тэгов HTML и тэгов шаблона, чтобы отформатировать представление этих элементов (таблицы HTML, фоновые цвета, размеры шрифта, стиля и т.д.). Однажды программист захочет изменить способ хранения статьи (сделать изменения в логике приложения). Это изменение не вызовет изменений в шаблонах. Содержание будет все еще передаваться в шаблон таким же самым способом. Аналогично, если верстальщик захочет полностью перепроектировать шаблоны, это не потребует никаких изменений в прикладной логике. Одно из предназначений Smarty - это отделение логики приложения от представления. Конечно же, шаблоны могут содержать в себе логику, но лишь при условии, что эта логика необходима для правильного представления данных. Такие задачи, как подключение других шаблонов, чередующаяся окраска строчек в таблице, приведение букв к верхнему регистру, циклический проход по массиву для его отображения и т.д. - всё это является примером логики представления. Не следует думать, что Smarty заставляет вас разделять логику приложения и представление. Smarty не видит разницы между этими вещами, так что помещать или не помещать логику приложения в шаблоны - решать вам. Если же вы считаете, что в шаблоне ВООБЩЕ не должно быть логики, вы можете ограничиться использованием чистого текста и переменных. Одна из уникальных возможностей Smarty - компилирование шаблонов. Это означает, что Smarty читает файлы шаблонов и создает PHP-код на их основе. Код создаётся один раз и потом только выполняется. Поэтому нет необходимости обрабатывать файл шаблона для каждого запроса и каждый шаблон может пользоваться всеми преимуществами таких кэшируюших решений, как Zend Accelerator (&url.zend;) или PHP Accelerator (&url.php-accelerator;). Некоторые особенности Smarty: Он очень быстр. Он эффективен, так как PHP обработчик делает за него грязную работу. Никакой лишней обработки шаблонов, они компилируются только один раз. Перекомпилируются только те шаблоны, которые изменились. Вы можете создавать пользовательские функции и модификаторы, что делает язык шаблонов чрезвычайно расширяемым. Настраиваемые разделители тэгов шаблона, то есть вы можете использовать {}, {{}}, <!--{}-->, и т.д. Конструкции if/elseif/else/endif конструкции передаются обработчику PHP, так что синтаксис {if ...} выражения может быть настолько простым или сложным, насколько вам угодно. Допустимо неограниченное вложение секций, условий и т.д. Существует возможность включения PHP-кода прямо в ваш шаблон, однако обычно в этом нет необходимости (и это не рекоммендуется), так как движок весьма гибок в настройке. Встроенное кэширование. Произвольные источники шаблона. Пользовательские функции кэширования. Компонентная архитектура. Для установки и работы Smarty необходим веб-сервер с установленным PHP версии 4.0.6 или выше. Скопируйте файлы Smarty, которые находятся в директории /libs/ дистрибутива. Менять эти файлы НЕ СЛЕДУЕТ. Они должны использоваться всеми приложениями и изменяться только при обновлении Smarty до новой версии. Smarty использует PHP константу SMARTY_DIR, которая указывает путь к директории библиотеки Smarty. Обычно, если приложение может найти файл Smarty.class.php, то нет необходимости устанавливать SMARTY_DIR. Однако, если Smarty.class.php не может быть найден в вашем include_path или вы не указывали абсолютный путь к нему в приложении, то вы должны определить SMARTY_DIR вручную. SMARTY_DIR должен включать завершающий слэш. Как следует инстанциировать объект Smarty в ваших PHP-скриптах: ]]> Попробуйте выполнить вышеуказанный код. Если Вы получаете ошибку о том, что Smarty.class.php не найден, попробуйте следующие варианты: ]]> ]]> ]]> Теперь, когда все файлы находятся на своих местах, пришло время установки директорий Smarty в вашем приложении. Smarty требует четыре директории, которые (по умолчанию) называются templates, templates_c, configs и cache. Каждая из них определяется свойствами класса Smarty: $template_dir, $compile_dir, $config_dir, и $cache_dir соответственно. Настойчиво рекомендуется использовать разные наборы этих директорий для каждого приложения, использующего Smarty. Убедитесь, что вы знаете значение DOCUMENT_ROOT вашего веб-сервера. В нашем примере это "/web/www.mydomain.com/docs/". Так как к файлам Smarty будут обращаться только скрипты, то вам рекомендуется вынести директории Smarty за пределы DOCUMENT_ROOT, чтобы избежать лишнего беспокойства относительно безопасности. В нашем примере мы будем устанавливать Smarty для некоторой гостевой книги. Приложение было выбрано только для того, чтобы использовать его имя в именах директорий. Вы можете использовать те же настройки с любым другим приложением, просто меняя "guestbook" на имя вашего приложения. Мы же разместим наши директории Smarty тут: "/web/www.mydomain.com/smarty/guestbook/". Вам понадобится как минимум один файл в корне веб-директории - это скрипт, к которому обращается веб-браузер. Мы назовём наш скрипт "index.php" и поместим его в поддиректорию "/guestbook" корневой веб-директории. Бывает удобно настроить веб-сервер так, чтобы "index.php" расценивался как индексный файл дирекотрии по умолчанию, чтобы при запросе страницы "http://www.mydomain.com/guestbook/", вызывался скрипт index.php без "index.php" в конце URL'а. В веб-сервере Apache вы можете настроить это добавив "index.php" в конец директивы DirectoryIndex (записи разделяются пробелами). Давайте взгляним на текущую файловую структуру: Smarty понадобятся права на запись в $compile_dir и $cache_dir, так что убедитесь, что у веб-сервера есть эти права. Обычно он запущен под именем пользователя "nobody" группы "nobody". Для пользователей OS X пользователем по умолчанию является "www" группы "www". Если вы используете Apache, вы можете заглянуть в ваш файл httpd.conf (который обычно расположен в "/usr/local/apache/conf/") чтобы узнать, какие используются имя пользователя и группа. chmod 770 даёт достаточно жесткую защиту - только пользователь "nobody" и группа "nobody" имеют доступ на запись и чтение к директориям. Если вы хотите открыть доступ на чтение для всех (обычно для собственного удобства при просмотре этих файлов), вы можете использовать маску 775. Нам необходимо создать файл index.tpl, которы будет загружаться Smarty. Он будет расположен в вашей $template_dir. {* Smarty *} - это комментарий шаблона. Он не является обязательным, но его размещение в начале каждого шаблона является хорошим тоном. Это позволяет проще различать файлы независимо от их расширения. К примеру, текстовые редакторы могут узнавать файл и включать особенную подсветку синтаксиса. Теперь давайте отредактируем index.php. Мы создадим экземпляр Smarty, присвоим значение переменной шаблона и отобразим файл index.tpl. В окружении нашего примера мы поместили "/usr/local/lib/php/Smarty" в include_path. Убедитесь, что вы сделали то же самое или используете абсолютные пути. 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'); ?> ]]> В нашем примере, мы устанавливаем абсолютные пути ко всем директориям Smarty. Если '/web/www.mydomain.com/smarty/guestbook/' находится в include_path вашего PHP, то эти настройки не обязательны. Тем не менее, более эффективным и (из опыта) менее глюкоопасным является использование абсолютных путей. Это даст вам уверенность в том, что Smarty получает файлы из тех директорий, из которых вы хотите. Теперь загрузите файл index.php из вашего веб-браузера. Вы должны увидеть надпись "Hello, Ned!" Вы закончили базовую установку Smarty! Эта глава является продолжением базовой установки; пожалуйста, сперва прочитайте её. Немного более гибким способом установки Smarty является наследование класса и инициализация вашего собственного окружения Smarty. Таким образом, вместо того, чтобы постоянно устанавливать пути директорий, присваивать одни и те же переменные и т.д. мы можем всё это сделать в одном месте. Давайте создадим новую директорию "/php/includes/guestbook/", а в ней - новый файл, который назовем "setup.php". В окружении из нашего примера "/php/includes" находится в include_path. Проверьте, что бы то же самое было и у вас, или используетй абсолютные пути. Smarty(); $this->template_dir = '/web/www.mydomain.com/smarty/guestbook/templates/'; $this->compile_dir = '/web/www.mydomain.com/smarty/guestbook/templates_c/'; $this->config_dir = '/web/www.mydomain.com/smarty/guestbook/configs/'; $this->cache_dir = '/web/www.mydomain.com/smarty/guestbook/cache/'; $this->caching = true; $this->assign('app_name','Guest Book'); } } ?> ]]> Теперь давайте изменим index.php для использования setup.php: assign('name','Ned'); $smarty->display('index.tpl'); ?> ]]> Теперь вы видите, что создать экземпляр Smarty довольно просто - нужно лишь использовать Smarty_GuestBook, который автоматически инициализирует все настройки для нашего приложения.