- What is Symfony?
- Get started
- Documentation
- Community
- Services
-
News
Latest News
What happened last week in Symfony?
This week, the new Symfony 2.3 branch was created. In addition, the first Symfony 2.3 release candidate version was published, which includes tons of great small improvements. Lastly, one of the biggest Symfony events of the year, the Symfony Live Portland 2013 conference, will take place next week.
Upcoming EventsThe Symfony Community organizes events all over the world on a regular basis. Here are the next ones.
Netherlands, Utrecht — Symfony Meetup - Netherlands/Utrecht
on May 22, 2013, from 19:00 to 22:00
France, Montpellier — eZ UnConference #2
from May 27, 2013 to May 29, 2013
Germany, München — Symfony User Group München
on June 05, 2013, from 18:30 to 22:30
Germany, Köln — Symfony User Group Cologne steht an!
on June 05, 2013, from 19:00 to 22:00 - About
Table of Contents
Questions & Feedback
Found a typo or an error?
Want to improve this document? Edit it.
Need support or have a technical question?
Post to the user mailing-list.
Master Symfony2 fundamentals
Symfony hosting done right
Discover the SensioLabs Support
The Templating Component
The Templating Component¶
Templating provides all the tools needed to build any kind of template system.
It provides an infrastructure to load template files and optionally monitor them for changes. It also provides a concrete template engine implementation using PHP with additional tools for escaping and separating templates into blocks and layouts.
Installation¶
You can install the component in many different ways:
- Use the official Git repository (https://github.com/symfony/Templating);
- Install it via Composer (
symfony/templatingon Packagist).
Usage¶
The PhpEngine class is the entry point
of the component. It needs a template name parser
(TemplateNameParserInterface) to
convert a template name to a template reference and template loader
(LoaderInterface) to find the
template associated to a reference:
1 2 3 4 5 6 7 8 9 | use Symfony\Component\Templating\PhpEngine;
use Symfony\Component\Templating\TemplateNameParser;
use Symfony\Component\Templating\Loader\FilesystemLoader;
$loader = new FilesystemLoader(__DIR__ . '/views/%name%');
$view = new PhpEngine(new TemplateNameParser(), $loader);
echo $view->render('hello.php', array('firstname' => 'Fabien'));
|
The render() method executes
the file views/hello.php and returns the output text.
1 2 | <!-- views/hello.php -->
Hello, <?php echo $firstname ?>!
|
Template Inheritance with Slots¶
The template inheritance is designed to share layouts with many templates.
1 2 3 4 5 6 7 8 9 | <!-- views/layout.php -->
<html>
<head>
<title><?php $view['slots']->output('title', 'Default title') ?></title>
</head>
<body>
<?php $view['slots']->output('_content') ?>
</body>
</html>
|
The extend() method is called in the
sub-template to set its parent template.
1 2 3 4 5 6 7 8 9 10 11 | <!-- views/page.php -->
<?php $view->extend('layout.php') ?>
<?php $view['slots']->set('title', $page->title) ?>
<h1>
<?php echo $page->title ?>
</h1>
<p>
<?php echo $page->body ?>
</p>
|
To use template inheritance, the SlotsHelper
helper must be registered:
1 2 3 4 5 6 7 8 | use Symfony\Component\Templating\Helper\SlotsHelper;
$view->set(new SlotsHelper());
// Retrieve page object
$page = ...;
echo $view->render('page.php', array('page' => $page));
|
Note
Multiple levels of inheritance is possible: a layout can extend an other layout.
Output Escaping¶
This documentation is still being written.
The Asset Helper¶
This documentation is still being written.
NEWS FROM THE BLOG
IN THE NEWS
is a trademark of Fabien Potencier. All rights reserved.