Symfony Components

What's in for you?

Fabien Potencier

Fabien Potencier
Serial entrepreneur and developer by passion
Founder of Sensio (in 1998)
A services and consulting company
specialized in Web technologies
and Internet marketing (France and USA)
70 people
Open-Source specialists
Big corporate customers
Consulting, training, development, web design, and more
Sponsor of a lot of Open-Source projects
like symfony and Doctrine

Fabien Potencier
Creator and lead developer of symfony
and creator and lead developer of some more OSS:
symfony components
Swift Mailer : Powerful component based mailing library for PHP
Twig : Fexible, fast, and secure template language for PHP
Pirum : Simple PEAR Channel Server Manager
Sismo : PHP continuous integration server
Lime : Easy to use unit testing library for PHP
Twitto : A web framework in a tweet
Twittee : A Dependency Injection Container in a tweet
Pimple : A small PHP 5.3 dependency injection container

Fabien Potencier
Read my technical blog: http://fabien.potencier.org/
Follow me on Twitter: @fabpot
Fork my code on Github: http://github.com/fabpot/

How many of you use

symfony?

symfony
Full-stack framework (MVC architecture)
symfony provides the infrastructure/tools needed for 95% of the web
projects
Open-Source (MIT License) since 2005
Based on
11 years of Sensio experience building websites for its customers
Existing Open-Source projects

But wait,
symfony is a monolithic
framework, right?

A bit of history
symfony 1.0 (January 2007) started as a glue between existing
Open-Source libraries

A bit of history
symfony 1.1 (June 2008) was a big refactoring of the code base
Decoupled the main component: like Forms, Routing, Cache, YAML, ORMs,
sfRequest

sfYAML

sfRouting

sfDatabase

sfLogger

sfForm

sfValidator

sfI18N

sfEventDispatcher

sfWidget

sfUser

sfStorage

sfResponse

sfCache

sfOutputEscaper

sfCoreAutoload

platform

The symfony (1.2/1.3/1.4) MVC

framework is based on a set of
cohesive but decoupled classes,
the symfony components

Symfony Components

Announced in May 2009

Standalone components
Packaged individually
No dependencies
Release cycle independent of Symfony, the framework

Symfony Components

Dedicated website for each component (with code and documentation)

http://components.symfony-project.org/

Dedicated Subversion and Git repository

http://svn.symfony-project.com/components/
http://github.com/fabpot

Symfony Components

They have been migrated to PHP 5.3

http://svn.symfony-project.com/branches/2.0/lib/Symfony/Components

Symfony Components

Each old PHP 5.2 symfony component has been branched

and a 1.0 version will be released soon
http://svn.symfony-project.com/components/

Symfony Components
Extracted from symfony 1
Event Dispatcher
YAML
Output Escaper

Written from scratch for Symfony 2

Dependency Injection Container
Request Handler
Templating

We dont want to duplicate eort done by Zend Framework

Symfony\Components\Templating

Symfony Templating

Thin layer on top of PHP

that adds some template-oriented features

Can work with Template Engines (Smarty, Twig, )

New Templating Framework

4 sub-components
Template Engine
Template Renderers
Template Loaders
Template Storages

use Symfony\Components\Templating\Engine;
use Symfony\Components\Templating\Loader\FilesystemLoader;
$loader = new FilesystemLoader(
'/path/to/templates/%name%.php'
);
$t = new Engine($loader);
echo $t->render('index', array('name' => 'Fabien'));

Template Loaders
No assumption about where and how templates are to be found
Filesystem
Database
Memory,

Built-in loaders: FilesystemLoader, ChainLoader,

Template names are logical names:

CacheLoader

$loader = new FilesystemLoader('/path/to/templates/%name%.php');

Template Renderers
No assumption about the format of the templates
Template names are prexed with the renderer name:
index == php:index
user:index
$t = new Engine($loader, array(
'user' => new ProjectTemplateRenderer(),
'php' => new PhpRenderer(),
));

Template Embedding

Hello <?php echo $name ?>

<?php $this->render('embedded', array('name' => $name)) ?>
<?php $this->render('smarty:embedded') ?>

Template Inheritance
<?php $this->extend('layout') ?>
Hello <?php echo $name ?>
<html>
<head>
</head>
<body>
<?php $this->output('content') ?>
</body>
</html>

Template Slots
<html>
<head>
<title><?php $this->output('title') ?></title>
</head>
<body>
<?php $this->output('content') ?>
</body>
</html>
<?php $this->set('title', 'Hello World! ') ?>
<?php $this->start('title') ?>
Hello World!
<?php $this->stop() ?>

Template Multiple Inheritance

A layout can be decorated by another layout

Each layout can override slots

Templating
A CMS example

http://fabien.potencier.org/talk/33/php-barcelona-symfony-2-0-on-PHP-5-3?position=76

Symfony Components
Dependency Injection

Symfony\Components\DependencyInjection

Dependency Injection is where components

are given their dependencies through their
constructors, methods, or directly into elds.
http://www.picocontainer.org/injection.html

class Message
{
public function __construct()
{
$this->output = new Output();
}
}

class Message
{
public function __construct(OutputInterface $output)
{
$this->output = $output;
}
}

DI Hello World example

class Message
{
public function __construct(OutputInterface $output, array $options)
{
$this->output = $output;
$this->options = array_merge(array('with_newline' => false), $options);
}
public function say($msg)
{
$this->output->render($msg.($this->options['with_newline'] ? "\n" : ''));
}
}

DI Hello World example

interface OutputInterface
{
public function render($msg);
}
class Output implements OutputInterface
{
public function render($msg)
{
echo $msg;
}
}
class FancyOutput implements OutputInterface
{
public function render($msg)
{
echo sprintf("\033[33m%s\033[0m", $msg);
}
}

DI Hello World example

$output = new FancyOutput();

$message = new Message($output, array('with_newline' => true));
$message->say('Hello World');

A DI container facilitates
objects description and object relationships,
congures and instantiates objects

DI Container Hello World example

use Symfony\Components\DependencyInjection\Builder;
use Symfony\Components\DependencyInjection\Reference;
$container = new Builder();
$container->register('output', 'FancyOutput');
$container->
register('message', 'Message')->
setArguments(array(new Reference('output'), array('with_newline' => true)))
;
$container->message->say('Hello World!');

$message = $container->message;
Get the conguration for the message service
The Message constructor must be given an output service
Get the output object from the container
Create a Message object by passing the constructor arguments

$message = $container->message;

is roughly equivalent to
$output = new FancyOutput();
$message = new Message($output, array('with_newline' => true));!

$container = new Builder();

$container->register('output', 'FancyOutput');
$container->
register('message', 'Message')->
setArguments(array(new Reference('output'), array('with_newline' => true)))
;
$container->message->say('Hello World!');

PHP

<container xmlns="http://symfony-project.org/2.0/container">
<services>
<service id="output" class="FancyOutput" />

XML

<service id="message" class="Message">

<argument type="service" id="output" />
<argument type="collection">
<argument key="with_newline">true</argument>
</argument>
</service>
</services>
</container>
$container = new Builder();
$loader = new XmlFileLoader($container);
$loader->load('services.xml');

XML is validated
against an XSD

$container = new Builder();

$container->register('output', 'FancyOutput');
$container->
register('message', 'Message')->
setArguments(array(new sfServiceReference('output'), array('with_newline' => true)))
;
$container->message->say('Hello World!');
services:
output: { class: FancyOutput }
message:
class: Message
arguments:
- @output
- { with_newline: true }
$container = new Builder();
$loader = new YamlFileLoader($container);
$loader->load('services.yml');

PHP
YAML

<container xmlns="http://symfony-project.org/2.0/container">
<parameters>
<parameter key="output.class">FancyOutput</parameter>
<parameter key="message.options" type="collection">
<parameter key="with_newline">true</parameter>
</parameter>
</parameters>
<services>
<service id="output" class="%output.class%" />
<service id="message" class="Message">
<argument type="service" id="output" />
<argument>%message.options%</argument>
</service>
</services>
</container>
$container = new Builder();
$loader = new XmlFileLoader($container);
$loader->load('services.xml');

<container xmlns="http://symfony-project.org/2.0/container">
<imports>
<import resource="config.xml" />
</imports>
<services>
<service id="output" class="%output.class%" />
<service id="message" class="Message">
<argument type="service" id="output" />
<argument>%message.options%</argument>
</service>
</services>
</container>
<container xmlns="http://symfony-project.org/2.0/container">
<parameters>
<parameter key="output.class">FancyOutput</parameter>
<parameter key="message.options" type="collection">
<parameter key="with_newline">true</parameter>
</parameter>
</parameters>
</container>
$container = new Builder();
$loader = new FileXmlFileLoader($container);
$loader->load('services.xml');

<services>
<import resource="config.yml" class="Symfony\Components\DependencyInjection
\Loader\YamlFileLoader" />
<service id="output" class="%output.class%" />
<service id="message" class="Message">
<argument type="service" id="output" />
<argument>%message.options%</argument>
</service>
</services>
parameters:
output.class: FancyOutput
message.options: { with_newline: true }
$container = new Builder();
$loader = new XmlFileLoader($container);
$loader->load('services.xml');

Loaders & Dumpers

IniFileLoader
XmlFileLoader
YamlFileLoader

XmlDumper
YamlDumper
Make your container
PhpDumper
VERY fast
GraphvizDumper

use
use
use
use
use
use
use

Symfony\Components\DependencyInjection\Builder;
Symfony\Components\DependencyInjection\Reference;
Symfony\Components\DependencyInjection\Dumper\XmlDumper;
Symfony\Components\DependencyInjection\Dumper\YamlDumper;
Symfony\Components\DependencyInjection\Dumper\PhpDumper;
Symfony\Components\DependencyInjection\Loader\XmlFileLoader;
Symfony\Components\DependencyInjection\Loader\YamlFileLoader;

$container = new Builder();

$container->register('output', 'FancyOutput');
$container->
register('message', 'Message')->
setArguments(array(new Reference('output'), array('with_newline' => true)))
;

$dumper = new XmlDumper($container);

file_put_contents(__DIR__.'/container.xml', $dumper->dump());
$loader = new XmlFileLoader($container);
$loader->load(__DIR__.'/container.xml');
$dumper = new YamlDumper($container);
file_put_contents(__DIR__.'/container.yml', $dumper->dump());
$loader = new YamlFileLoader($container);
$loader->load(__DIR__.'/container.yml');
$dumper = new PhpDumper($container);
echo $dumper->dump();

use Symfony\Components\DependencyInjection\Container;
use Symfony\Components\DependencyInjection\Reference;
use Symfony\Components\DependencyInjection\Parameter;
class ProjectServiceContainer extends Container
{
protected $shared = array();
protected function getOutputService()
{
if (isset($this->shared['output'])) return $this->shared['output'];
$instance = new FancyOutput();
return $this->shared['output'] = $instance;
}
protected function getMessageService()
{
if (isset($this->shared['message'])) return $this->shared['message'];
$instance = new Message($this->getService('output'), array('with_newline' => true));
return $this->shared['message'] = $instance;
}
}

use Symfony\Components\DependencyInjection\Dumper\GraphvizDumper;
$dumper = new GraphvizDumper($container);
echo $dumper->dump();

digraph sc {
ratio="compress"
node [fontsize="11" fontname="Arial" shape="record"];
edge [fontsize="9" fontname="Arial" color="grey" arrowhead="open" arrowsize="0.5"];
node_output [label="output\nFancyOutput\n", shape=record, fillcolor="#eeeeee", style="filled"];
node_message [label="message\nMessage\n", shape=record, fillcolor="#eeeeee", style="filled"];
node_service_container [label="service_container\nSymfony\\Components\\DependencyInjection\\Builder
\n", shape=record, fillcolor="#9999ff", style="filled"];
node_message -> node_output [label="" style="filled"];
}

Symfony Components
Output Escaper

Symfony\Components\OutputEscaper

Output Escaper
Provides automatic XSS protection for your templates
By wrapping template variables
Works for
strings
arrays
objects

properties
methods
__call(), __get(),
Iterators, Coutables,

Works for deep method calls

use Symfony\Components\OutputEscaper\Escaper;
$title = 'Foo <br />';
echo Escaper::escape(ESC_SPECIALCHARS, $title);

use Symfony\Components\OutputEscaper\Escaper;
$article = array(
'title' => 'Foo <br />',
'author' => array(
'name' => 'Fabien <br/>',
)
);
$article = Escaper::escape(ESC_SPECIALCHARS, $article);
echo $article['title']."\n";
echo $article['author']['name']."\n";

class Article
{
protected $title;
protected $author;
public $full_title;

public property

public function __construct($title, Author $author)

{
$this->title = $title;
$this->full_title = $title;
$this->author = $author;
}
public method
public function getTitle() { return $this->title; }
public function getAuthor() { return $this->author; }
public function __get($key) { return $this->$key; }
public function __call($method, $arguments)
{
magic __call()
return $this->{'get'.$method}();
}
}

public method returning

another object
magic __get()

class Author
{
protected $name;
public function __construct($name) { $this->name = $name; }
public function getName() { return $this->name; }
}

use Symfony\Components\OutputEscaper\Escaper;
$article = new Article(
'foo <br />',
new Author('Fabien <br />')
);
$article = Escaper::escape(ESC_SPECIALCHARS, $article);
echo
echo
echo
echo
echo

$article->getTitle()."\n";
$article->getAuthor()->getName()."\n";
$article->full_title."\n";
$article->title."\n";
$article->title()."\n";

Escaping Strategy
explicitly ask
for raw data
echo $article->getHtmlContent(ESC_RAW);

echo $article->getTitle(ESC_JS);
change the default
escaping strategy

symfony-live.com

with Matthew Weier OPheinney

I will reveal the first alpha release of Symfony 2.0!

symfony-live.com

with Matthew Weier OPheinney

with Matthew Weier O'Phinney as a special guest

Thank you!
My slides on slideshare.com/fabpot
with a bonus: How to use Symfony Components with ZF!

Sensio S.A.
92-98, boulevard Victor Hugo
92 115 Clichy Cedex
FRANCE
Tl. : +33 1 40 99 80 80
Contact
Fabien Potencier
fabien.potencier at sensio.com

http://www.sensiolabs.com/
http://www.symfony-project.org/
http://fabien.potencier.org/

S
U
N
BO
How to use Symfony Components
within a Zend Framework project?

Symfony components in a ZF project

Symfony Components can make your ZF application better
More congurable: symfony YAML
More exible: symfony Event Dispatcher
Faster: symfony Dependency Injection
More secure: symfony Output Escaper

and more fun of course

Symfony Components in a ZF project

The examples in this presentation are just to get you started faster
So, be creative with them. They open all kind of opportunities for your
next Zend Framework project
And please, give me feedback, and tell me what you do with the
Symfony Components

Symfony Components
Event Dispatcher

class Bootstrap extends Zend_Application_Bootstrap_Bootstrap

{
public function run()
{
require_once '/path/to/sfEventDispatcher.php';
$dispatcher = new sfEventDispatcher();
$event = new sfEvent(null, 'bootstrap.prerun');
$dispatcher->notify($event);
parent::run();
$event = new sfevent(null, 'bootstrap.postrun');
$dispatcher->notify($event);
}
}

Symfony Components
Dependency Injection

class Bootstrap extends Zend_Application_Bootstrap_Bootstrap

{
public function getContainer()
{
if (null === $this->_container)
{
$this->setContainer($this->_initContainer());
}
return $this->_container;
}
protected function _initContainer()
{
require_once '/path/to/sfServiceContainerAutoloader.php';
sfServiceContainerAutoloader::register();

Example from Ben Eberlei (he rocks!): http://www.whitewashing.de/blog/articles/118

$container = new sfServiceContainerBuilder();

$loader = new sfServiceContainerLoaderFileXml($container);
$loader->load(dirname(__FILE__).'/configs/resources.xml');
return $container;
}
}

<?xml version="1.0" ?>

<container xmlns="http://symfony-project.org/2.0/container">
<parameters>
<parameter key="mailer.username">foo</parameter>
<parameter key="mailer.password">bar</parameter>
<parameter key="mailer.class">Zend_Mail</parameter>
</parameters>
<services>
<service id="mail.transport" class="Zend_Mail_Transport_Smtp" shared="false">
<argument>smtp.gmail.com</argument>
<argument type="collection">
<argument key="auth">login</argument>
<argument key="username">%mailer.username%</argument>
<argument key="password">%mailer.password%</argument>
<argument key="ssl">ssl</argument>
<argument key="port">465</argument>
</argument>
</service>
<service id="mailer" class="%mailer.class%">
<call method="setDefaultTransport">
<argument type="service" id="mail.transport" />
</call>
</service>
</services>
</container>

parameters:
mailer.username: foo
mailer.password: bar
mailer.class:
Zend_Mail
services:
mail.transport:
class:
Zend_Mail_Transport_Smtp
arguments: [smtp.gmail.com, { auth: login, username:
%mailer.username%, password: %mailer.password%, ssl: ssl, port: 465 }]
shared:
false
mailer:
class: %mailer.class%
calls:
- [setDefaultTransport, [@mail.transport]]

class GuestbookController extends Zend_Controller_Action

{
public function indexAction()
{
$guestbook = new Default_Model_Guestbook();
$this->view->entries = $guestbook->fetchAll();
$container = $this->getInvokeArg('bootstrap')->getContainer();
$mailer = $container->mailer;
}
}

Dependency Injection Container

By default in ZF, new resources can be added to the container but cannot
be lazy-loaded
All resources used by Zend_Application are loaded on every request

By using symfony Service Container, the resources are lazy-loaded

Instances and their dependencies are created the rst time you get them

Interesting for resources like DB

Symfony Components
Output Escaper

require_once '/path/to/sfOutputEscaperAutoloader.php';
sfOutputEscaperAutoloader::register();
class My_View extends Zend_View
{
public function __set($key, $val)
{
if ('_' === substr($key, 0, 1))
{
// throw an exception
}
$this->$key = sfOutputEscaper::escape(array($this, 'escape'), $val);
}
}

<dl>
<?php foreach ($this->entries as $entry): ?>
<dt><?php echo $this->escape($entry->email) ?></dt>
<dd><?php echo $this->escape($entry->comment) ?></dd>
<?php endforeach ?>
</dl>
<dl>
<?php foreach ($this->entries as $entry): ?>
<dt><?php echo $entry->email ?></dt>
<dd><?php echo $entry->comment ?></dd>
<?php endforeach ?>
</dl>
<?php echo $entry->getRawValue()->comment ?>
<?php echo $entry->getComment(ESC_RAW) ?>