Smarty - это компилирующий обработчик шаблонов для PHP. Говоря более четко, он предоставляет один из инструментов, которые позволяет добиться отделения прикладной логики и данных от представления. Это очень удобно в ситуациях, когда программист и верстальщик шаблона - различные люди. Например, скажем, вы создаете страницу, которая показывает газетную статью. Название статьи, автор и сама статья - элементы, которые не содержат никакой информации о том, как они будут представлены. Их передают в Smarty из приложения. Затем верстальщик шаблона редактирует шаблоны и использует комбинацию тэгов HTML и тэгов шаблона, чтобы отформатировать представление этих переменных, содержащих элементы типа таблиц HTML, фоновых цветов, размеров шрифта, стилей, SVG и т.д.). Однажды программист захочет изменить способ хранения статьи, то есть внести изменения в логику приложения. Это изменение не вызовет изменений в шаблонах. Содержание будет все еще передаваться в шаблон таким же самым способом. Аналогично, если верстальщик захочет полностью перепроектировать шаблоны, это не потребует никаких изменений в прикладной логике. Таким образом, программист может вносить изменения в прикладную логику без необходимости изменения шаблонов, а дизайнер шаблонов может вносить изменения в шаблоны без вреда для прикладной логики. Одно из предназначений Smarty - это отделение логики приложения от представления. Конечно же, шаблоны могут содержать в себе логику, но лишь при условии, что эта логика необходима для правильного представления данных. Такие задачи, как подключение других шаблонов, чередующаяся окраска строчек в таблице, приведение букв к верхнему регистру, циклический проход по массиву для его отображения и т.д. - всё это примеры логики представления. Тем не менее, не следует полагать, что Smarty заставляет вас разделять прикладную логику и логику представления. Smarty не видит разницы между этими вещами, так что переносить прикладную логику в шаблоны вы можете на свой страх и риск. Если же вы считаете, что в шаблоне вообще не должно быть логики, вы можете ограничиться использованием чистого текста и переменных. Одна из уникальных возможностей Smarty - компилирование шаблонов. Это означает, что Smarty читает файлы шаблонов и создает PHP-код на их основе. Код создаётся один раз и потом только выполняется. Поэтому нет необходимости в медленной обработке файл шаблона для каждого запроса. Каждый шаблон может пользоваться всеми преимуществами таких компиляторов PHP и кэшируюших решений, как eAccelerator, ionCube, mmCache, Zend Accelerator и прочих. Некоторые особенности Smarty: Он очень быстр. Он эффективен, так как обработчик PHP делает за него грязную работу. Никакой лишней обработки шаблонов, они компилируются только один раз. Перекомпилируются только те шаблоны, которые изменились. Вы можете легко создавать собственные пользовательские функции и модификаторы переменных, что делает язык шаблонов чрезвычайно расширяемым. Настраиваемые {разделители} тэгов шаблона, то есть вы можете использовать {$foo}, {{$foo}}, <!--{$foo}--> и т.д. Конструкции {if}..{elseif}..{else}..{/if} передаются обработчику PHP, так что синтаксис выражения {if...} может быть настолько простым или сложным, насколько вам угодно. Допустимо неограниченное вложение секций, условий и т.д. Существует возможность включения PHP-кода прямо в ваш шаблон, однако обычно в этом нет необходимости (и это не рекоммендуется), так как движок весьма гибок и расширяем. Встроенный механизм кэширования. Произвольные источники шаблонов. Пользовательские функции кэширования. Компонентная архитектура. Для установки и работы Smarty необходим веб-сервер с установленным PHP версии 4.0.6 или выше. Скопируйте файлы Smarty, которые находятся в субдиректории /libs/ дистрибутива. Редактировать эти PHP-файлы НЕ СЛЕДУЕТ. Они должны использоваться всеми приложениями и изменяться только при обновлении Smarty до новой версии. В следующих примерах архив с исходным кодом Smarty был распакован в /usr/local/lib/Smarty-v.e.r/ для машин под *nix и c:\webroot\libs\Smarty-v.e.r\ для машин под Windows. Smarty использует константу PHP SMARTY_DIR, которая указывает полный путь к директории libs/ из Smarty. Обычно, если ваше приложение может найти файл Smarty.class.php, то нет необходимости устанавливать SMARTY_DIR - Smarty сам во всём разберётся. Однако, если 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. В нашем примере мы будем устанавливать Smarty для некоторой гостевой книги. Приложение было выбрано только для того, чтобы использовать его имя в именах директорий. Вы можете использовать те же настройки с любым другим приложением, просто меняя guestbook/ на имя вашего приложения. Убедитесь, что вы знаете расположение корневой директории документов вашего веб-сервера. В следующих примерах, корневой директорией документов является /web/www.example.com/guestbook/htdocs/. Доступ к директориям Smarty происходит только из библиотеки Smarty и никогда не происходит через веб-браузер. Поэтому, в целях безопасности рекоммендуется располагать эти директории за пределами корневой директории документов сервера, хотя это и не обязательно. Вам понадобиться как минимум один файл внутри корневой директории документов - это скрипт, вызываемый веб-браузером. Мы назовем наш скрипт index.php и положим его в поддиректорию внутри корневой директории документов /htdocs/. Smarty понадобятся права на запись (пользователей Windows это не касается) в директории $compile_dir и $cache_dir (templates_c/ и cache/), так что убедитесь, что у веб-сервера есть эти права. Обычно это пользователь nobody и группа nobody. Для пользователей OS X, пользователь по умолчанию - это www и группа - www. Если вы используете Apache, вы можете узнать используемые имя пользователя и группу из файла httpd.conf. chmod 770 даёт достаточно жесткую защиту - разрешает только пользователю nobody и группе nobody доступ на чтение и запись в эти директории. Если вы хотите открыть доступ на чтение для всех (обычно для собственного удобства при просмотре этих файлов), вы можете использовать значение 775. Нам необходимо создать файл index.tpl, которы будет загружаться Smarty. Он будет расположен в $template_dir. {* Smarty *} - это комментарий шаблона. Он не является обязательным, но его размещение в начале каждого шаблона является хорошим тоном. Это позволяет проще различать файлы независимо от их расширения. К примеру, текстовые редакторы могут узнавать этот файл и включать особенную подсветку синтаксиса. Теперь давайте отредактируем index.php. Мы создадим экземпляр Smarty, присвоим значение переменной шаблона и отобразим файл index.tpl. template_dir = '/web/www.example.com/guestbook/templates/'; $smarty->compile_dir = '/web/www.example.com/guestbook/templates_c/'; $smarty->config_dir = '/web/www.example.com/guestbook/configs/'; $smarty->cache_dir = '/web/www.example.com/guestbook/cache/'; $smarty->assign('name', 'Катруська'); //** раскомментируйте следующую строку для отображения отладочной консоли //$smarty->debugging = true; $smarty->display('index.tpl'); ?> ]]> В нашем примере мы устанавливаем абсолютные пути ко всем директориям Smarty. Если /web/www.example.com/guestbook/ находится в include_path вашего PHP, то эти настройки не обязательны. Тем не менее, более эффективным и (из опыта) менее глюкоопасным является использование абсолютных путей. Это придаст уверенность в том, что Smarty получает файлы из тех директорий, из которых вы хотите. Теперь перейдите к файлу index.php при помощи вашего веб-браузера. Вы должны увидеть надпись "Привет, Катруська! Добро пожаловать в Smarty!" Вы закончили базовую установку Smarty! Эта глава является продолжением базовой установки; пожалуйста, сперва прочитайте её. Немного более гибким способом установки Smarty является наследование класса и инициализация вашего собственного окружения Smarty. Таким образом, вместо того, чтобы постоянно устанавливать пути директорий, присваивать одни и те же переменные и т.д., мы можем всё это сделать в одном месте. Давайте создадим новую директорию /php/includes/guestbook/,а в ней - новый файл, который назовем setup.php. По условиям нашего примера, /php/includes находится в include_path. Убедитесь, чтобы то же самое было и у вас, или используетй абсолютные пути. Smarty(); $this->template_dir = '/web/www.example.com/guestbook/templates/'; $this->compile_dir = '/web/www.example.com/guestbook/templates_c/'; $this->config_dir = '/web/www.example.com/guestbook/configs/'; $this->cache_dir = '/web/www.example.com/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, который автоматически инициализирует все настройки для нашего приложения.