smarty php код в шаблоне
Шаблонизатор Smarty
Smarty это компилирующий обработчик шаблонов для PHP позволяющий отделить логику и HTML-верстку веб-приложения.
Скачать библиотеку и посмотреть документацию можно на https://www.smarty.net/download
Содержание архива smarty-3.1.32.zip переносим в директорию /smarty/ в корень сайта, в index.php подключаем библиотеку и задаем переменные шаблона.
Вывод переменных
В PHP эта запись аналогична:
Также можно вывести значение массива по ключу.
В PHP это выглядело бы так:
Задание значений переменных
Катенация переменной с текстом:
Значение по умолчанию
Если переменная не существует или пуста, можно задать текст который будет выводится вместо нее.
Применение строковых функций
Переменные можно модифицировать встроенными функции, например, перевести символы в верхний регистр.
Допустимо комбинировать сразу несколько функций:
| lower | Переводит строку в нижний регистр |
| upper | Переводит строку в верхний регистр |
| capitalize | Преобразовывает первые буквы каждого слова в заглавные |
| strip | Заменяет все повторяющиеся пробелы |
| nl2br | Заменяет перевод строки в тэг |
| strip_tags | Удаляет html тэги |
| escape | Используется для кодирования спецсимволов |
Глобальные переменные PHP
| $_GET | |
| $_POST | |
| $_SESSION | |
| $_COOCIES | |
| $_REQUEST |
Управляющие конструкции
Как и в PHP, в Smarty доступны управляющие конструкции, операторы и необходимые функции.
If, else
Switch Case
Циклы
Foreach
Встроенные функции Smarty
Include
literal
Вставки JS и CSS нужно обворачивать тегами
Введение в шаблонизатор Smarty
Дата публикации: 2012-02-13
От автора: Одной из важнейших задач любого хорошего веб-разработчика является разделение логики сайта от его представления (дизайна). Это разделение обеспечивает несколько преимуществ:
а) гибкость приложения – четкое разделение логики от дизайна позволяет программистам вносить изменения в логику и структуру сайта, не затрагивая его оформления, и в тоже время дает возможность дизайнерам изменять внешний вид сайта и при этом не затрагивать логическую часть веб – приложения;
б) код веб-приложения становится чистым и элегантным;
Думаю многие веб-разработчики, сталкивались с этой проблемой – решением данной задачи является применение шаблонов. В этом уроке мы будем изучать применение шаблонов с использованием шаблонизатора Smarty.
Бесплатный курс по PHP программированию
Освойте курс и узнайте, как создать динамичный сайт на PHP и MySQL с полного нуля, используя модель MVC
В курсе 39 уроков | 15 часов видео | исходники для каждого урока
1. Формирование задачи
Давайте для начала определимся, что же такое шаблон? Шаблон — это довольно широкое понятие, но если говорить простым языком – это файл (документ), обычно в html или tpl формате, который содержит в себе html – теги (оформление и структуру веб-приложения), а также специальные метки, вместо которых подставляются данные из логической части данных. Подстановкой данных и формированием окончательного вида веб-приложения занимается шаблонизатор.
Существует огромное множество готовых шаблонизаторов для PHP. Конечно, шаблонизатор можно написать и самому – придумать свои метки для шаблона и разработать алгоритм замены этих меток. Но этот вариант не очень удобен, если Ваше веб-приложение будут обслуживать другие программисты или дизайнеры, так как в этом случае их придется посвящать в нюансы Вашего шаблонизатора. Поэтому лучше всего использовать готовое проверенное решение с хорошим функционалом и качественной документацией.
Smarty – наиболее популярная и широко распространенная система шаблонов на PHP. Работа Smarty заключается в компилировании шаблонов. Это означает, что Smarty последовательно считывает разметку файла шаблона и создает на их основе готовый PHP сценарий, этот сценарий создается один раз, а далее просто выполняется. Smarty содержит в себе большое количество функций, которые позволяют создавать в шаблонах сложную логику (если она нужна для правильного отображения данных): подключение других шаблонов, циклический разбор массива и т.д. Конечно, Вы можете и не создавать сложную логику шаблона, а ограничиться лишь использованием чистого текста и переменных.
На этом вводная часть закончена и можно приступать к изучению.
2. Установка Smarty
Скачать Smarty можно с официального сайта //www.smarty.net/, перейдя на вкладку Download. На момент создания урока последняя стабильная версия это Smarty 3.1.7, ее и скачиваем. При распаковке архива мы видим папку Smarty 3.1.7, а в ней еще файлы и папки:
demo – демонстрационный пример использования шабонизатора;
libs – папка с дистрибутивом Smarty;
различные текстовые файлы(readme, описание условий копирования, описания отличий от более старых версий).
Для установки Smarty необходимо скопировать папку libs (из архива) в корневой каталог Вашего веб-приложения. Перечень файлов и папок каталога libs должен быть таким:
libs/
Smarty.class.php
SmartyBC.class.php
debug.tpl
sysplugins
plugins
Затем создать четыре директории, из которых Smarty будет читать свои конфигурационные файлы и файлы шаблонов. По умолчанию эти директории имеют название: templates/, templates_c/, configs/, cache/(эти каталоги Вы можете назвать так, как Вам захочется, но при этом нужно будет указать шаболнизатору на их названия – это мы рассмотрим далее). Таким образом каталог с Вашим веб-приложением должен быть следующего вида:
www.example.com/(или папка с Вашим веб-приложением)
libs/
Smarty.class.php
SmartyBC.class.php
debug.tpl
sysplugins
plugins
templates
templates_c
configs
cache
index.php
Давайте рассмотрим, для чего нужны созданные четыре каталога:
templates – здесь хранятся Ваши созданные шаблоны (шаблоны для Smarty создаются в формате tpl);
templates_c – в этот каталог шаблонизатор записывает скомпилированный шаблон, на основе шаблона в каталоге templates;
configs – каталог для хранения файлов конфигурации;
cache – каталог для хранения кэшированных файлов шаблона.
Get Smarty
Resources
Donate
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Sites Using Smarty
Advertisement
Ресурсы
Шаблоны из произвольной папки
Example 15.7. Вызов шаблона из произвольной папки
А изнутри шаблона Smarty:
Файловые пути в Windows
Если вы работаете под Windows, то пути к файлам, как правило, начинаются с буквы логического диска (например, C:). Не забудьте указать префикс «file:» в начале пути, чтобы избежать конфликтов имён и достичь необходимого результата.
Example 15.8. использование шаблонов с файловіми путями Windows
А изнутри шаблона Smarty:
Шаблоны из прочих источников
Вы можете вызывать шаблоны, используя любые доступные через PHP источники: базы данных, сокеты, LDAP и так далее. Для этого нужно написать соответствующий плагин ресурса и зарегистрировать его в Smarty.
Смотрите раздел плагины ресурсов для более подробной информации о тех функциях, которые вы должны предоставить.
Example 15.9. Использование собственных ресурсов
А изнутри шаблона Smarty:
Функция для обработки шаблона по умолчанию
Вы можете определить функцию, которая будет использована, если шаблон не может быть вызван из соответствующего ресурса. Это можно использовать, к примеру, для построения недостающего шаблона на лету.
Example 15.10. использование функции для обработки шаблона по умолчанию
Get Smarty
Resources
Donate
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Sites Using Smarty
Advertisement
Ресурсы
Шаблоны из произвольной папки
Example 15.7. Вызов шаблона из произвольной папки
А изнутри шаблона Smarty:
Файловые пути в Windows
Если вы работаете под Windows, то пути к файлам, как правило, начинаются с буквы логического диска (например, C:). Не забудьте указать префикс «file:» в начале пути, чтобы избежать конфликтов имён и достичь необходимого результата.
Example 15.8. использование шаблонов с файловіми путями Windows
А изнутри шаблона Smarty:
Шаблоны из прочих источников
Вы можете вызывать шаблоны, используя любые доступные через PHP источники: базы данных, сокеты, LDAP и так далее. Для этого нужно написать соответствующий плагин ресурса и зарегистрировать его в Smarty.
Смотрите раздел плагины ресурсов для более подробной информации о тех функциях, которые вы должны предоставить.
Example 15.9. Использование собственных ресурсов
А изнутри шаблона Smarty:
Функция для обработки шаблона по умолчанию
Вы можете определить функцию, которая будет использована, если шаблон не может быть вызван из соответствующего ресурса. Это можно использовать, к примеру, для построения недостающего шаблона на лету.
Example 15.10. использование функции для обработки шаблона по умолчанию
Наследование шаблонов в Smarty
Когда-то, давным-давно, мне пришлось использовать небезызвестный шаблонизатор Smarty. Сначала я, понятное дело, возмущался и кричал, какая же гадость эта заливная рыба Smarty, а потом «распробовал» и втянулся. Те удобства, которые он давал, с лихвой компенсировали мысли о том, что есть и более быстрые шаблонные движки.
Шаблоны я обычно строил с помощью инклюдов: в начале подключался header.tpl, в конце — footer.tpl, в середине ещё что-нибудь нужное. В целом разметка получалась довольно аккуратной, но не проходило ощущение, что не хватает чего-то важного. Окончательно понимание этого чего-то появилось, когда мне случилось написать простенькое приложение на Django. И это «что-то», как все поняли, оказалось наследованием шаблонов. Простая, как и всё гениальное, идея позволяла существенно упростить шаблоны и избавиться от дублирующих блоков.
Решение оказалось не сложнее самой идеи наследования, которая, напомню, была простой, как и всё гениальное 🙂
Примечание: дабы не плодить сущего, я не буду пересказывать статью про наследование шаблонов в Django, однако рекомендую её прочитать, дабы примерно понять, что нас ждёт и чтобы по исходным текстам шаблонов можно было понять, что они делают
child.tpl:
index.php:Особо, думаю, ничего пояснять не надо: перед компиляцией шаблона блок
А результат работы выглядит вот так:
Идея вкратце такова: внутри объекта шаблонизатора введём ассоциативный массив, ключами которого будут имена наследуемых блоков, а соответствующими им значениями — массивы, содержащие текстовые содержания этих блоков, хранящиеся в порядке их (блоков) вызова. Согласен, фраза получилась заумной, поэтому проще показать на предыдущем примере:
Надеюсь, всё просто. Теперь остаётся при вызове блока в шаблоне «достать» из этого хранилища последний элемент и отобразить его на месте тегов 🙂
Пусть блок будет отвечать за получение исходного кода шаблона-родителя, а — за создание и переопределение наследуемых блоков.
Мануал поможет нам создать блоковые плагины:
block.extends.php:block.block.php:Здесь надо сказать, что setBlock() и getBlock() — методы шаблонизатора, которые соответственно помещают и получают текстовые значения наследуемых блоков из стека, про который было сказано выше. Расширим класс Smarty, введя массив стека и методы:
Ленивые могут скачать готовый пример шаблонов и пощупать на деле (архив весит 2.2 кб, Smarty в комплект поставки, естественно, не входит).