symfony - introduction

A Better Way to Build

Thursday, 27 September 12

Piers Warmers

@warmers

@pierswarmers


What’s on tonight?


Session 1.


Session 1.

• Introduction


Session 1.

• Introduction

• What is Symfony?


Session 1.

• Introduction


• Core concepts


Session 1.

• Introduction


• Core concepts

• A typical application


Session 1.

• Introduction


• Core concepts

• A typical application

• Lets code!


Session 2.


Session 2.

• CRUD and MVC (with the model)


Session 2.


• Cleaning up our interfaces


Session 2.



• Forms and validation


Session 2.




• Services and dependancy injection


Session 2.





• An overview of security


Session 2.






• Using Symfony components without symfony


ce qui est Symfony?


Symfony is…


Symfony is…

• a full stack framework (PHP 5.3+)


“Symfony is a reusable set of standalone, decoupled and cohesive PHP components that solve common

web development problems”Dries Buytaert (Founder of Drupal)


Problems?


Problems?

• Connect requests to business logic (route ➜ code)


Problems?


• Handle environment configuration (dev, test, prod)


Problems?



• Secure an application (authentication, firewalls)


Problems?




• Render a response (templates)


Problems?





• Speed things up (compiling, caching, ESI, proxies)


Problems?





• Speed things up (compiling, caching, ESI, proxies)

• I18N & L10N (translations, regional formatting)


Standalone, decoupled?


Symfony & Components

BrowserKit

ClassLoader

Config

Console

CssSelector

DependencyInjection

DomCrawler

EventDispatcher

Finder

Form

HttpFoundation

HttpKernel

Locale

Process

Routing

Security

Serializer

Templating

Translation

Validator

Yaml

includes

See: http://symfony.com/components


http://symfony.com/components

http://symfony.com/components

“Let's try to eliminate the NIH

syndrome in the PHP world!”Fabien Potencier (Founder of Symfony)


http://en.wikipedia.org/wiki/Not_invented_here

http://en.wikipedia.org/wiki/Not_invented_here

https://connect.sensiolabs.com/api/alternates/4aed4f5d-e0cb-4320-902f-885fddaa7d15

https://connect.sensiolabs.com/api/alternates/4aed4f5d-e0cb-4320-902f-885fddaa7d15

Drupal & Symfony

BrowserKit

ClassLoader

Config

Console

CssSelector

DependencyInjection

DomCrawler

EventDispatcher

Finder

Form

HttpFoundation

HttpKernel

Locale

Process

Routing

Security

Serializer

Templating

Translation

Validator

Yaml

using

Version 8+


https://github.com/drupal/drupal/blob/8.x/index.php




Symfony is…

• a full stack framework (PHP 5.3+) ✓


Symfony is…


• application methodology (best practices, standards)


“A most important, but also most elusive, aspect of any tool is its

influence on the habits of those who

train themselves in its use.”Edsger Dijkstra (Computer Scientist)


Influence by example…



• a blueprint for applications (shape, vernacular)




• best practices (quality, testing)




• best practices (quality, testing)

• standardisation and consistency (PSR-0, PSR-1, PSR-2)


Symfony is…


• application methodology (best practices, standards) ✓


Symfony is…



• an enthusiastic community (it’s about people)


…and theres lots of them!



• large community (http://connect.sensiolabs.com)


http://connect.sensiolabs.com




• regional events (SymfonyLive - Paris, London, Berlin, San Francisco)







• involved (http://symfony.com/contributors)







• involved (http://symfony.com/contributors)

• like to share (open source, permissive MIT style)




Symfony is…




Symfony is…



• an enthusiastic community (it’s about people) ✓


Lets Go!Time to setup a project.


Installation in three steps



• get composer



• get composer

• create project



• get composer

• create project

• start server


Dependency management

Satis


So the installation in three steps…


Get composer - it’s crazy simple!


Create a project


Run the server, we’re online!


Lets look inside ./demo1


The important parts…



• app ➜ AppKernal, cache, configuration, logs, console




• composer.json ➜ dependancy map





• composer.lock ➜ what was actually installed






• src ➜ you’re code goes here







• vendor ➜ other peoples code goes here (via composer)








• web ➜ server loads app.php here which loads…








• web ➜ server loads app.php here which loads…

AppKernal.php


In the browser


The console


./app/console


The console


The console

• Time savers: build models, controllers and bundles


The console


• Manage cache removal


The console



• Update database schema


The console




• Send spooled emails


The console





• Build you own CLI tasks


The console





• Build you own CLI tasks

• Run the PHP test server


Built in PHP server is good for quick testing but... don’t use in production!


What’s my normal setup?



• PHP 5.4.6



• PHP 5.4.6

• MySQL 5.5.25a MySQL Community Server



• PHP 5.4.6

• MySQL 5.5.25a MySQL Community Server

• Apache HTTP Server 2.2.22


Let’s look at the config…


Configure: hosts


Configure: Apache HTTP


Configure: MySQL CE


Through Apache


The Web Debug Toolbar


Web Debug Toolbar


Web Debug Toolbar

• Displays resource usage


Web Debug Toolbar


• Monitors code execution times


Web Debug Toolbar



• Presents info on session, logs, exceptions


Web Debug Toolbar




• Provides insight into persistence layer


Web Debug Toolbar




• Provides insight into persistence layer

• Good for showing off in meetings


“Hello world!”The Demo App


What’s just happened?

Route

htpp://…/hello/SydPHP

Request

Controller

View


What’s just happened?

/demo/hello/{name}

htpp://…/demo/hello/SydPHP

authentication, authorisation, resolving etc…

AcmeDemoBundle->helloAction($name)

hello.html.twig

layout.html.twig


./app/config/routing_dev.yml


./src/Acme/DemoBundle/Controller/DemoController.php


./src/Acme/DemoBundle/Resources/views/Demo/hello.html.twig


A template enginefor PHP?


Twig template engine



• Fast (compiled to optimised PHP)




• Concise (easy to learn, clean, designers will love you)


For example:

Output in PHP:

Output in Twig:


Twig templating




Twig templating



• Secure (escaped output, sandboxed)


Twig templating




• Extendable (custom tags and filters)


Twig templating





• Helps enforce SoC (helps keep templates for display only)


Twig templating





• Helps enforce SoC (helps keep templates for display only)

• Totally optional (you can still use PHP or both)


Twig templates can extend Layouts


(simplified)./src/Acme/DemoBundle/Resources/views/layout.html.twig


Coming up…


Coming up…






• Using Symfony components without symfony


big thanks to

SensioLabs

PizzaTime!


Quick recap…


Quick recap…

• We have a simple application setup


Quick recap…


• We’ve looked at:


Quick recap…



• routing


Quick recap…



• routing

• controllers


Quick recap…



• routing

• controllers

• templates


Quick recap…



• routing

• controllers

• templates

• Lets build a simple CRUD application


CRUD and MVC

Route

htpp://…/products

Request

Controller

Model View


Doctrine DBAL and ORM


Before we get started…


Bundles & namespacesare your friends…


Bundles & namespacesare your friends…

image by sergiu_bacioiu @


• Make life simpler (after some wtf moments)



• Should follow FIG standards (www.php-fig.org)


http://www.php-fig.org/



• Should follow FIG standards (www.php-fig.org)

• Makes autoloading a breeze (ClassLoader component)

See here: http://symfony.com/doc/current/components/class_loader.html




http://symfony.com/doc/current/components/class_loader.html

http://symfony.com/doc/current/components/class_loader.html

• \Zend\Mail\Message ➜

/path/to/project/lib/vendor/Zend/Mail/Message.php


• \Zend\Mail\Message ➜

/path/to/project/lib/vendor/Zend/Mail/Message.php

• \Symfony\Core\Request ➜

/path/to/project/lib/vendor/Symfony/Core/Request.php


Lets create our own bundleAcme/Bundle/BlogBundle


./app/config/parameters.ymlGenerate the new bundle


The modelLets create our Doctrine entity


./app/config/parameters.ymlGenerate the new entity


The CRUD logicLets create our Controller


./app/config/parameters.ymlGenerate the new entity


2 Errors


Oh snap: part 1


./app/config/parameters.yml will fix this


Oh snap: part 2


Update the databaseThere’s a task for that.


./app/config/parameters.ymlGenerate the update query


Looks good, sort of?


Cleaning up


Cleaning up

• Add our new layout template (apply it to views)


Cleaning up


• Add some CSS (quick look at asset linking)


Cleaning up


• Add some CSS (quick look at asset linking)

• Discover Assetic (images, css, javascript etc…)


./app/config/parameters.ymlLets use this simple template


./app/config/parameters.ymlAnd apply it to our templates


Why this?{{ asset('bundles/acmeblog/css/demo.css') }}



• Can prefix different paths (dev vs prod)



• Can prefix different paths (dev vs prod)

• Can be used for cache busting (v1, v2, v3, etc…)


./app/config/parameters.yml./app/config/config.yml


Assetic is the next step



• Advanced filters:




• Images (jpegoptim, optipng)





• CSS (combine and compress)






• JS (combine and compress)






• JS (combine and compress)

• LESS, SASS (compile, combine, compress)


./app/config/parameters.ymlUpdate the layout…


Forms & Validation


Forms Widgets


./app/config/parameters.ymlSimple, elegant presentation


Constraints & Assertions


./app/config/parameters.ymlAssertions in annotations


Services


Lets improve Postwho’s setting the “created_at” property?


./app/config/parameters.ymlIn the model?


./app/config/parameters.ymlOn the object?


Maybe there’s a better way?


./app/config/parameters.ymlServices are global toolkits


Service ContainersDependancy Injection


“Dependency injection is a software design pattern that allows a choice of component to be made at run-time rather than

compile time. This can be used, for example, as a simple way to load plugins dynamically or to choose mock objects in test

environments vs. real objects in production environments.”Wikipedia


http://en.wikipedia.org/wiki/Software_design_pattern

http://en.wikipedia.org/wiki/Software_design_pattern

http://en.wikipedia.org/wiki/Plug-in_(computing)

http://en.wikipedia.org/wiki/Plug-in_(computing)

http://en.wikipedia.org/wiki/Mock_object

http://en.wikipedia.org/wiki/Mock_object

Finishing up


Finishing up

• Security (broad topic, demo app has an example)


Finishing up


• Firewalls (protect areas of application via routes)


Finishing up



• Authentication providers (in memory, HTTP, build you own, FOSUserBundle)


Finishing up



• Authentication providers (in memory, HTTP, build you own, FOSUserBundle)

• Authorisation (ACL in config or DB)


Out of time…Thursday, 27 September 12

A huge thanks to…

• SensioLabs: t-shirts, pizza, support

• SydPHP: organisation, support


Slides will be up on Speaker Deck shortly…

@warmers


symfony - introduction

Documents

e symfony

symfony isthursday

interfaces forms

application authentication

validation services

dependancy injectionthursday

response templatesthursday

overview of securitythursday