Приступая к работе Что такое Smarty? Smarty - это компилирующий обработчик шаблонов для PHP и на PHP. Говоря более четко, он предоставляет один из инструментов, которые позволяет добиться разделения прикладной логики и от представления. Это очень удобно в ситуациях, когда программист и верстальщик шаблона - различные люди. Например, скажем, вы создаете страницу, которая показывает газетную статью. Название статьи, автор и сама статья - элементы, которые не содержат никакой информации о том, как они будут представлены. Их передают в Smarty из приложения, а верстальщик шаблона редактирует шаблоны и использует комбинацию тэгов HTML и тэгов шаблона, чтобы отформатировать представление этих элементов (таблицы HTML, фоновые цвета, размеры шрифта, стиля и т.д.). Однажды программист захочет изменить способ хранения статьи (сделать изменения в логике приложения.) Это изменение не вызовет изменений в шаблонах. Содержание будет все еще передаваться в шаблон таким же самым способом. Аналогично, если верстальщик захочет полностью перепроектировать шаблоны, это не потребует никаких изменений к прикладной логике. Теперь коротко о том, чего не может 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 Попробуйте выполнить вышеуказанный код. Если Вы получаете ошибку о том, что Smarty.class.php не найден, попробуйте следующие варианты: Укажите абсолютный путь к директории Smarty Добавьте директорию Smarty к include_path Установите значение константы SMARTY_DIR Теперь, когда все файлы находятся на своих местах, пришло время установки директорий 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/". 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: Example file structure 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. Setting file permissions Technical Note chmod 770 will be fairly tight security, it only allows user "nobody" and group "nobody" read/write access to the directories. If you would like to open up read access to anyone (mostly for your own convenience of viewing these files), you can use 775 instead. We need to create the index.tpl file that Smarty will load. This will be located in your $template_dir. Editing /web/www.mydomain.com/smarty/guestbook/templates/index.tpl Technical Note {* Smarty *} is a template comment. It is not required, but it is good practice to start all your template files with this comment. It makes the file easy to recognize regardless of the file extension. For example, text editors could recognize the file and turn on special syntax highlighting. 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. Editing /web/www.mydomain.com/docs/guestbook/index.php 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'); ]]> Technical Note In our example, we are setting absolute paths to all of the Smarty directories. If '/web/www.mydomain.com/smarty/guestbook/' is within your PHP include_path, then these settings are not necessary. However, it is more efficient and (from experience) less error-prone to set them to absolute paths. This ensures that Smarty is getting files from the directories you intended. Now load the index.php file from your web browser. You should see "Hello, Ned!" You have completed the basic setup for Smarty! Extended Setup This is a continuation of the basic installation, please read that first! A slightly more flexible way to setup Smarty is to extend the class and initialize your Smarty environment. So instead of repeatedly setting directory paths, assigning the same vars, etc., we can do that in one place. Lets create a new directory "/php/includes/guestbook/" and make a new file called "setup.php". In our example environment, "/php/includes" is in our include_path. Be sure you set this up too, or use absolute file paths. Editing /php/includes/guestbook/setup.php 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'); } } ]]> Now lets alter the index.php file to use setup.php: Editing /web/www.mydomain.com/docs/guestbook/index.php assign('name','Ned'); $smarty->display('index.tpl'); ]]> Now you see it is quite simple to bring up an instance of Smarty, just use Smarty_GuestBook which automatically initializes everything for our application.