The Wonderful World of Symfony Components

The Wonderful World of the
Symfony Components

by your friend:

Ryan Weaver
@weaverryan

Friday, September 28, 12

Who is this dude?
• That “Docs” guy
• KnpLabs US - Symfony consulting, training, Kumbaya
• Writer for KnpUniversity.com
screencasts
• Husband of the much more
talented @leannapelham

knplabs.com
@weaverryan github.com/weaverryan

Intro

Life before components
(The Desert of the Real)


Symfony consists of 23
individual components


Components are available
via Composer


Snooze...


Who Cares?


1

We Suck at Sharing
and that sucks for you

@weaverryan

Including External Libraries
is Depressing


The Big Bummer :(

• How do I autoload their files?
• Does their library depend on anything else?
• How do I even store their files in my project?

@weaverryan

Include a Zend Framework 1
component in symfony1


manually download the
library and commit it
into your project


if you don’t want the
WHOLE library, carefully
delete everything except
the dependent components


autoloading is completely
custom ... blah gross!


2
Components are the key to
mastering your framework

@weaverryan

3

If PHP is big, we’ll thrive
If PHP is small, we’ll die

@weaverryan

Communities

http://www.ﬂickr.com/photos/kitty-kat/

PHP is Huge! Right?

@weaverryan

PHP > Ruby

@weaverryan

Fragmentation

http://www.ﬂickr.com/photos/slpunk99/7329609744

But fragmentation makes us tiny, isolated, and
misguided trend-setters
@weaverryan

PHP frameworks < Rails

@weaverryan

I don’t want a damned
CakePHP Plugin!

CakePHP

CodeIgniter

@weaverryan

Fragmentation
• More information we have to know
• Difficult to hire
• Disjointed forums, StackOverflow
• Interoperability? What’s that?

@weaverryan

Components are shareable
across all of PHP


Act 1

Making Sharing Sexy


PHP Framework
Interoperability Group

http://www.php-ﬁg.org/


The United Nations of PHP


(A)

The Problem of Autoloading


My Autoloader doesn’t like
your PHPs
• The symfony1 autoloader doesn’t know where ZF1
classes live. The Zf1 autoloader doesn’t know where
symfony1 classes live

• Each library has its own autoloader that you must
discover, configure and use

@weaverryan

like a town where every
store has its own currency


From The Mountain:
PSR-0 Class Naming Conventions

“Thou shalt name your classes by
following a predictable pattern”

@weaverryan

class:
sfRequest

path:
lib/vendor/symfony/???idk


class:
SymfonyComponentHttpFoundationRequest

path:
vendor/symfony/src/Symfony/Component/
HttpFoundation/Request.php


use SymfonyComponentClassLoaderUniversalClassLoader;

$loader = new UniversalClassLoader();
$loader->registerNamespaces(array(
'Zend' => __DIR__.'/path/to/zf'
));

$loader->register();


(B)

Managing Vendors in your
project


Composer


1) Composer.json

{
"require": {
"zendframework/ldap": "2.0.x-dev"
}
}


2) Composer.phar

$ curl -s https://getcomposer.org/installer | php

$ php composer.phar install


3) Use It

require 'vendor/autoload.php';

use ZendLdapLdap;

$options = array(...);
$ldap = new Ldap($options);


Act 2

Your friendly, neighborhood
Symfony Components


The Symfony Components
• HttpFoundation • OptionsResolver
• HttpKernel • Console
• Event Dispatcher • Filesystem
• Routing • Finder
• CSSSelector • Locale
• DomCrawler • Process
• BrowserKit • Serializer
• Config • Templating
• Yaml • Form
• DependencyInjection • Translation
• Security • Validator
@weaverryan

• DomCrawler The Process
• “Framework”
Components
• Yaml • Form
@weaverryan

Level 1

HttpFoundation
symfony/http-foundation


Fun to Install!
{
"require": {
1 "symfony/http-foundation": "2.1.x-dev"
}
}

2 php composer.phar install

<?php
// your app
3

@weaverryan

? ?
Request ? Response
/foo ? <h1>Hi!</h1>
? ?

Mystery
PHP Code

@weaverryan

The Request


GET /foo?p=v1 HTTP/1.1
Host: knplabs.com
Accept: text/html
User-Agent: Mozilla/5.0

// /foo?p=v1
$uri = $_SERVER['REQUEST_URI'];
$p = isset($_GET['p']) ? $_GET['p'] : '';
$host = $_SERVER['HTTP_HOST'];
$accept = $_SERVER['HTTP_ACCEPT'];
$ua = $_SERVER['HTTP_USER_AGENT'];


GET /foo?p=v1 HTTP/1.1
Host: knplabs.com
Accept: text/html
User-Agent: Mozilla/5.0

use SymfonyComponentHttpFoundationRequest;
$request = Request::createFromGlobals();

$uri = $request->getPathInfo(); /foo
$p = $request->query->get('p');
$host = $request->getHost();
$accept = $request->headers->get('Accept');


The Response


HTTP/1.1 200 OK
Date: Tue, 04 Jun 2011 21:05:05 GMT
Content-Type: text/html
Set-Cookie:foo=fooval; path=/; httponly

<h1>Foo!</h1>

header('Content-Type', 'text/html');
setcookie('foo', 'fooval');
echo '<h1>Foo!</h1>';


HTTP/1.1 200 OK
Date: Tue, 04 Jun 2011 21:05:05 GMT
Content-Type: text/html
Set-Cookie:foo=fooval; path=/; httponly

<h1>Foo!</h1>

use SymfonyComponentHttpFoundationResponse;
use SymfonyComponentHttpFoundationCookie;

$response = new Response('<h1>Foo!</h1>');
$cookie = new Cookie('foo', 'fooval');
$response->headers->setCookie($cookie);

$response->send();

A Mini Framework


// not dependable!
$uri = $_SERVER['REQUEST_URI'];

ob_start();
if ($uri == '/') {
echo 'Homepage! o/';
} else {
echo 'sad missing page :/';
}

header('X-TOKEN: Foo');

ob_end_flush();

Symfony3
$req = Request::createFromGlobals();

if ($req->getPathInfo() == '/') {
$res = new Response('Homepage! o/');
} else {
$res = new Response('sad missing page :/');
}

$res->headers->set('X-SECRET', 'Foo');

$res->send();


Get some learning about
HttpFoundation

• Docs: http://bit.ly/sf2-http-foundation
• Code: http://bit.ly/sf2-http-foundation-code
• API: http://bit.ly/sf2-http-foundation-api

@weaverryan

Level 2

HttpKernel
symfony/http-kernel


Request
Framework

? Determine ?
the controller
?

Execute it

Response
Flush the Response
@weaverryan

Framework:

A pattern for converting a
request into a response


Request
HttpKernel

? Determine ?
the controller
?

Execute it

Response
Flush the Response
@weaverryan

$kernel = new HttpKernel(...);
$response = $kernel->handle($request);
$response->send();

There be magic inside!


These lines execute your
Symfony application

(hint, see - web/app.php)

... and Drupal 8 too ...


Yea, this is abstract

Stay Tuned...


Level 3

EventDispatcher
symfony/event-dispatcher


A classic “observer pattern”

Tell me when Liz
gets to work

Listener
Event
Dispatcher
Listener

Tell me when Liz
gets to work
@weaverryan

• Event Dispatcher: a classic “observer pattern”
Yo! I’m at
work!

Listener
Event
Dispatcher
Listener

@weaverryan


Liz is at
work!

Listener
Event
Dispatcher
Listener

Liz is at
work!
@weaverryan


She’s the best
around!

Listener
Event
Dispatcher
Listener

I’m totally
going to go talk
with her!!

Level 4

Routing
symfony/routing


Url
Router

Match against
a route
Route

Return info
about the route
Route

@weaverryan

$loader = new ClosureLoader();
$router = new Router($loader, function() {
$collection = new RouteCollection();

$route = new Route('/blog/{slug}');
$collection->add('blog', $route);

return $collection;
});
$results = $router->match('/blog/sflive');

array(
'slug' => 'sflive',
'_route' => 'blog',
)

$loader = new ClosureLoader();
$router = new Router($loader, function() {
$collection = new RouteCollection();

$route = new Route('/blog/{slug}', array(
'_controller' => 'SomeBundle:Blog:show'
));
$collection->add('blog', $route);

return $collection;
});
$results = $router->match('/blog/sflive');

array(
'_controller' => 'SomeBundle:Blog:show',
'slug' => 'sflive',
'_route' => 'blog'
)

Input: Request Information

Output: An array of info


Level 5

A “Framework”


$kernel = new HttpKernel(...);
$response = $kernel->handle($request);
$response->send();


HttpKernel::handle()
HttpFoundation

+
EventDispatcher

+
Routing (optional)
=
Framework
@weaverryan

HttpKernel::handle()
Request

+
Determine Controller

+
Controller Returns a Response
=
Response
@weaverryan

Homework:
Hack your Framework

... or do Karaoke later... your call


HttpKernel::handleRaw()
private function handleRaw(Request $request, $type = self::MASTER_REQUEST)
{
    // request
    $event = new GetResponseEvent($this, $request, $type);
    $this->dispatcher->dispatch(KernelEvents::REQUEST, $event);

    if ($event->hasResponse()) {
        return $this->filterResponse($event->getResponse(), $request, $type);
    }

    // load controller
The kewlest code I know about... seriously
    if (false === $controller = $this->resolver->getController($request)) {
        throw new NotFoundHttpException('Unable to find the controller);
    }

    $event = new FilterControllerEvent($this, $controller, $request, $type);
    $this->dispatcher->dispatch(KernelEvents::CONTROLLER, $event);
    $controller = $event->getController();

    // ... returns a response
}

@weaverryan

step/var_dump()die; the core

• SymfonyComponentHttpKernelHttpKernel::handle()
http://bit.ly/sf2-http-kernel-code

• Symfony Framework Important Classes
SymfonyComponentHttpKernelEventListenerRouterListener
- Executes the routing

SymfomyBundleFrameworkBundleControllerControllerResolver
- Parses _controller and instantiates the controller object

@weaverryan

Timeline of events in the Symfony Framework

kernel.request

kernel.controller

kernel.response


Profile events in the Symfony Framework


Awesome
Tools
• DomCrawler • Process
• Yaml • Form
@weaverryan

Now with more
Windows Love!
Process

symfony/process

Find Symfony’s Process on Packagist.org
{
"require": {
1
"symfony/process": "2.1.x-dev"
}
}

2 php composer.phar install

<?php
// your app
3

@weaverryan

External Script to Cook Dinner
<?php
// dinner.php

for ($i = 1; $i <= 3; $i++) {
sleep(1);
echo sprintf("Cooking... %sn", $i);
}

echo "DING! n";


Run the script synchronously


// app.php

use SymfonyComponentProcessProcess;

$process = new Process('php dinner.php');
// if dinner takes longer than 5 seconds
// to cook, freak out!
$process->setTimeout(5);

$process->run(function($type, $buffer) {
echo $buffer;
});

// executed after the command finishes
if (!$process->isSuccessful()) {
throw new Exception('Process misbehaved')
}

Run the script asynchronously


$process->start();

// do more work here
echo "WORKING!!! n";

while ($process->isRunning()) {
// wait for the process to finish
};
echo $process->getOutput();


Interacting via Stdin


$process->setStdin('turkey');

“turkey” is read from Stdin

Handling things that blow up!
$process->run(function($type, $buffer) {
if ($type == 'err') {
// perhaps do some logging?
echo $buffer;
}
});

if (!$process->isSuccessful()) {
echo sprintf(
"Process failed! Exit code %s, '%s'n",
$process->getExitCode(),
$process->getExitCodeText()
);
}


Find out more about Process

• Docs: http://bit.ly/sf2-process
• Code: http://bit.ly/sf2-process-code
• API: http://bit.ly/sf2-process-api

@weaverryan

@kriswallsmith

SPORK!
$manager = new SporkProcessManager();
$manager->fork(function() {
// do something in another process!
return 'Hello from '.getmypid();
})->then(function(SporkFork $fork) {
// do something in the parent process afterwards
echo "{$fork->getPid()} says '{$fork->getResult()}'";
});

Fork yourself some more PHP

https://github.com/kriswallsmith/spork


Finder

symfony/finder


From the Fablog
use SymfonyComponentsFinderFinder;

$s3 = new Zend_Service_Amazon_S3($key, $secret);
$s3->registerStreamWrapper("s3");

$finder = new Finder();
$finder->name('photos*')
->size('< 100K')
->date('since 1 hour ago');
foreach ($finder->in('s3://bucket-name') as $file) {
// do something

print $file->getFilename()."n";
}

http://fabien.potencier.org/article/44/php-iterators-and-
streams-are-awesome

Find(er) out more about Finder

• Docs: http://bit.ly/sf2-finder
• Code: http://bit.ly/sf2-finder-code
• API: http://bit.ly/sf2-finder-api

@weaverryan

New in 2.1!
Filesystem

symfony/filesystem


Find Symfony’s Filesystem on Packagist.org
{
"require": {
1 "symfony/filesystem": "2.1.x-dev"
}
}

2 php composer.phar update symfony/filesystem

<?php
// your app
3

@weaverryan

// ...

use SymfonyComponentFilesystemFilesystem;

$filesystem = new Filesystem();
$filesystem->copy(
'cowboy.jpg',
's3://my-bucket/cowboy.jpg'
);
$filesystem->copy(
's3://my-bucket/rodeo.mov',
'rodeo.mov'
);
$filesystem->mirror(
'thumbnails',
's3://my-bucket/thumbnails'
);

// ...

use SymfonyComponentFinderFinder;

$finder = new Finder();
$finder->name('*.jpg')
->date('since 1 hour ago');
->in('thumbs');
$filesystem->chmod($finder, 0777);


// ...


$filesystem->touch('foo.txt');
$filesystem->chmod('foo.txt', 0777);
$filesystem->symlink('/some/dir', '/symlink/target')


Find out more about Filesystem

• Docs: http://bit.ly/sf2-filesystem
• Code: http://bit.ly/sf2-filesystem-code
• API: http://bit.ly/sf2-filesystem-api

@weaverryan

Console

symfony/console


<?php
// command.php

$loader = require 'vendor/autoload.php';
$loader->add('App', __DIR__);

use SymfonyComponentConsoleApplication;
use AppCommandEchoCommand;

$app = new Application();
$app->add(new EchoCommand());
$app->run();


namespace AppCommand;

use SymfonyComponentConsoleCommandCommand;
use SymfonyComponentConsoleInputInputInterface;
use SymfonyComponentConsoleOutputOutputInterface;

class EchoCommand extends Command
{
protected function configure()
{
$this->setName('echo')->addArgument('msg');
}

public function execute(
InputInterface $input,
OutputInterface $output)
{
$output->writeln('Yo '.$input->getArgument('msg'));
}
}


Output with pretty colors


Find out more about Command

• Docs http://bit.ly/sf2-console
• Code http://bit.ly/sf2-console-code
• API http://api.symfony.com/master/namespaces.html
-> and search for “Console”

@weaverryan

If you download Composer
in the next 5 minutes, we’ll
throw in a special gift!


CssSelector + DomCrawler

symfony/css-selector
symfony/dom-crawler


use SymfonyComponentDomCrawlerCrawler;

$html = <<<'HTML'
<!DOCTYPE html>
<html>
<body>
<p class="message">Hello World!</p>
<p>Hello Crawler!</p>
</body>
</html>
HTML;

$crawler = new Crawler($html);

$crawler->filter('p')->eq(0)->attr('class');
$crawler->filter('p')->eq(1)->text();


Goutte!


Config

symfony/config


Config

• Load configuration from many formats (YAML,
PHP files, XML)

• Config Validation
• Caching for parsed config

@weaverryan

Validator

symfony/validator


Shh... a little setup



use SymfonyComponentValidatorValidator;
use SymfonyComponentValidatorMappingClassMetadataFactory;
use SymfonyComponentValidatorConstraintValidatorFactory;

// a little setup
$metadata = new ClassMetadataFactory();
$constraintFactory = new ConstraintValidatorFactory();
$validator = new Validator($metadata, $constraintFactory);


use SymfonyComponentValidatorConstraintsEmail;

$value = 'ryan[AT]knplabs.com';
$email = new Email();
$email->message = 'Invalid! You entered {{ value }}';
$errors = $validator->validateValue($value, $email);

if (count($errors) > 0) {
echo strtr(
$errors[0]->getMessageTemplate(),
$errors[0]->getMessageParameters()
);
}


34 Core Validators and counting
• String length See the “Reference”
• Regular expressions
section of the docs
• Ip addresses
• Dates
• Collections
• File size, mime-type, etc
... and the brand new Luhn validator
for credit card numbers thanks to
@merk ----------------------------------->

@weaverryan

But wait there’s more!


More Components
• DependencyInjection
• Security
• OptionsResolver
• Locale
• Serializer
• Templating
• Form
• Translation

@weaverryan

Many components are easy


Some are still wtf-hard


(cough) Security (cough)


Documentation
Documentation
Documentation


The Security Component

https://github.com/symfony/symfony-docs/pull/1604

WIP by @matthiasnoback


Act 3

Kicking ass in the new
PHP eco-system


The PHP Ecosphere
Symfony is only one part of the picture

• Symfony
• Zend Framework
• EZ Components
• Drupal
• ...
• Individuals

What other stuff exists?

@weaverryan

How do we find good
libraries?


Some Favorites


Mink
behat/mink
http://mink.behat.org/

By @everzet, written on
Fabien’s childhood computer

Command a browser, find elements, click
them, and fill out forms

$driver = new BehatMinkDriverSahiDriver('firefox');
$session->visit('http://my_project.dev/some_page.php');

$page = $session->getPage();

$anchor = $page->find('css', '.something');
$anchor->click();

// get the content of the new page
echo $page->getContent();


Monolog
monolog/monolog
https://github.com/Seldaek/monolog

Your Friend Jordi


A Logger, where bells and whistles
come standard
use MonologLogger;
use MonologHandlerStreamHandler;
use MonologHandlerFirePHPHandler;

// Create the logger
$logger = new Logger('my_logger');
$logger->pushHandler(new StreamHandler(
__DIR__.'/my_app.log'
));
$logger->pushHandler(new FirePHPHandler());

$logger->addInfo('My logger is now ready');


Zend Framework 2

They have some stuff


Yay Find More!


Epilogue

4 Reasons to get
silly-excited about
the Future


1) Look for Participation &
Consolidation


Shared Building-blocks

• Drupal
• phpBB
• Midgard
• Zikula
• ez Publish 5
• ...

@weaverryan

Less Library Duplication?

• Zend/Form • Symfony/Form
• Zend/Serializer • Symfony/Serializer
• Zend/Http • Symfony/HttpFoundation
• Zend/EventManager • Symfony/EventDispatcher
• Zend/Log • Monlog
• Zend/Navigation • KnpMenu
• ... • ...

@weaverryan

2) More high quality,
community-grown libraries


Solving 1 specific problem
is a low barrier to entry


Find them, fork them.


Write their docs :)


Programmers that write
docs get hugs


3) Easier upgrades


4) Grow your Community


Solutions exist outside of
your framework


Fabien will not come to your
house and tell you about them


Cast your vote by using the
best libraries and improving
them


and realize the power of
the entire PHP community


Thanks...
Ryan Weaver
@weaverryan


... and we love you!
https://joind.in/7218

Ryan Weaver
@weaverryan

Ryan Weaver
@weaverryan

The Wonderful World of Symfony Components

More Related Content

Viewers also liked (20)

Similar to The Wonderful World of Symfony Components (20)

More from Ryan Weaver (20)

Recently uploaded (20)

The Wonderful World of Symfony Components