Symfony2 for Midgard Developers
-
Upload
henri-bergius -
Category
Technology
-
view
7.784 -
download
1
description
Transcript of Symfony2 for Midgard Developers
Symfony2 for Midgard Developers
Symfony2 is becoming the de-facto web framework for PHP 5.3
Drupal
Zend Framework
Midgard MVC
MidCOM
The PHP world is starting to unite around Symfony2
Under MIT LicenseCopyright (c) 2004-2011 Fabien PotencierPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the followingconditions:The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OROTHER DEALINGS IN THE SOFTWARE.
Symfony 2.0 was released on July 28 2011
Symfony2 is a collection of standalone PHP componentsbundled together into a single framework
You can choose what to take, and what to not use
✔ Authentication and Authorization✔ Forms and Validation✔ Templating✔ Logging✔ Asset Management✔ Routing✔ Internationalization✔ Console Tasks✔ Caching
Dependency Injection means you can changeany of these to another implementation
<?php $this->container->get('security.context')->isGranted( 'READ', $object)
The actual service checking this could beMidCOM-style ACL, or simple "allow authenticatedusers to do anything" check.
PHP 5.3 and namespaces
Midgard MVC & MidCOM
<?php class example_mycomponent_controllers_some {
Symfony2
<?php namespace Example\MyBundle\Controller; use Symfony\Framework\WebBundle\Controller; class SomeController extends Controller {
\ is the new _
With namespaces all projects can share one autoloader.
<?php $crRoot = realpath(__DIR__ . '/..');
// register the autoloaders require "{$crRoot}/SplClassLoader.php";
// Tell where Midgard stuff is $midgardAutoloader = new SplClassLoader('Midgard', "{$crRoot}/src"); $midgardAutoloader->register();
// Tell where code from some other project is $phpcrAutoloader = new SplClassLoader('PHPCR', "{$crRoot}/lib/PHPCR/src"); $phpcrAutoloader->register();
Time to get the hands dirty
You'll need:
• PHP 5.3• php5-midgard2• PEAR installer• Git
Symfony2 Standard Edition
http://symfony.com/download
$ php app/check.php ******************************** * * * Symfony requirements check * * * ********************************
php.ini used by PHP: /etc/php5/cli/php.ini
** Mandatory requirements **
OK Checking that PHP version is at least 5.3.2 (5.3.5-1ubuntu7.2 installed) OK Checking that the "date.timezone" setting is set OK Checking that app/cache/ directory is writable ...
Dependencies are defined in the deps file
[AsseticBundle] git=http://github.com/symfony/AsseticBundle.git target=/bundles/Symfony/Bundle/AsseticBundle version=v1.0.0RC2
Now you could just use the web dirstuff in your regular web server.
However, we'll be using AppServer-in-PHP
$ pear channel-discover pear.indeyets.pp.ru $ pear install indeyets/aip
Add AiP integration as dependency
[AppServerBundle] git=http://github.com/bergie/MidgardAppServerBundle.git target=Midgard/AppServerBundle
Install with $ php bin/vendors install --reinstall
Copy aip.yaml.example fromvendor/Midgard/AppServerBundleto the app dir as aip.yaml
Add Midgard namespace to autoloader
$loader->registerNamespaces(array( ... 'Midgard' => __DIR__.'/../vendor',
Start AiP aip app app/aip.yamlGo to http://localhost:8001
Now, to write some code!
$ php app/console generate:bundle
Let Symfony2 create a Acme/ExampleBundle for you.
src/Acme/ExampleBundle
http://localhost:8001/hello/World
src/Acme/ExampleBundle/Controller/DefaultController.php
<?php namespace Acme\ExampleBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template; class DefaultController extends Controller { /** * @Route("/hello/{name}") * @Template() */ public function indexAction($name) { return array('name' => $name); } }
src/Acme/ExampleBundle/Resources/views/Default/index.html.twig
Hello {{ name }}!
How did this template get loaded?
/** * @Template() */ ... return array('name' => $name);
⇒ Defaults to Bundle/Resources/views/Controller/action.html.twig
We could also do:
return $this->render( 'AcmeExampleBundle:Default:index.html.twig', array('name' => $name) );
Page generation process:
1. Match the URL to a route (/hello/{name}) /hello/World ⇒ /hello/{name}2. Instantiate Controller new Acme\ExampleBundle\Controller\DefaultController3. Run action method with arguments ->indexAction('World')3. Controller returns a Response Hello World!
Templating in Symfony2
Twig is the default templating engine for Symfony2
In Midgard you only define the elements you want to override
In Twig you define a new root element that inherits and thenoverrides.
src/Acme/ExampleBundle/Resources/views/Default/index.html.twig
{% extends 'AcmeDemoBundle::layout.html.twig' %}
{% block content %} Hello {{ name }}! {% endblock %}
http://localhost:8001/hello/World
You can also use other templating enginesTAL, PHP, MidCOM, ...
http://symfony.com/doc/2.0/cookbook/templating/PHP.html
Exercise:
Create your own base layout templateMake the route's template inherit that
Routing in Symfony2
Registering routes with PHP
app/config/routing.yml
AcmeExampleBundle: resource: "@AcmeExampleBundle/Controller/" type: annotation prefix: /
In Controller action methods:
/** * @Route("/hello/{name}") */
Registering routes with YAML
AcmeExampleBundle: resource: "@AcmeExampleBundle/Resources/config/routing.yml" prefix: /example
src/Acme/ExampleBundle/Resources/config/routing.yml
hello_user: pattern: /hello/{name} defaults: { _controller: AcmeExampleBundle:Default:index}
(format is NamespaceBundle:Controller:action)
$ php app/console router:debug
[router] Current routes Name Method Pattern _welcome ANY / _demo_login ANY /demo/secured/login _security_check ANY /demo/secured/login_check _demo_logout ANY /demo/secured/logout ... _configurator_final ANY /_configurator/final acme_example_default_index ANY /example/hello/{name}
Supporting other output formats
/** * @Route("/hello/{name}.{_format}", defaults={"_format"="html"}) */
http://localhost:8001/hello/World andhttp://localhost:8001/hello/World.htmlwill both work
src/Acme/ExampleBundle/Resources/views/Default/index.json.twig
{% set arr = { 'name': name } %} {{ arr | json_encode | raw }}
http://localhost:8001/hello/World.json
Exercise:
Create two routes• One with no parameters• One with two parameters• Provide a default value for parameter
Using Midgard inside Symfony2
Add Midgard ConnectionBundle as dependency
[MidgardConnectionBundle] git=git://github.com/bergie/MidgardConnectionBundle.git target=Midgard/ConnectionBundle
Install with $ php bin/vendors install
Enable in app/AppKernel.php
$bundles = array( ... new Midgard\ConnectionBundle\MidgardConnectionBundle() );
Configure Midgard connection
app/config/config.yml
midgard_connection: type: SQLite name: midgard2 databasedir: "%kernel.root_dir%" logfile: "%kernel.root_dir%/logs/midgard2.log" loglevel: debug blobdir: "%kernel.root_dir%/blobs" sharedir: "/usr/share/midgard2"
Now you can create a database
$ php app/console midgard:connection:init
Using Midgard in controllers
src/Acme/ExampleBundle/Controller/DefaultController.php
/** * @Route("/hello/{name}.{_format}", defaults={"_format"="html"}) * @Template() */ public function indexAction($name) { $qb = new \midgard_query_builder('midgard_person'); $qb->add_constraint('firstname', '=', 'Midgard'); $persons = $qb->execute(); return array('name' => $persons[0]->firstname); }
Hello, Midgard!
Exercise:
Create a route displaying all personobjects in the Midgard database
MidCOM components inside Symfony2
Warning: Here be Dragons
Add Midgard MidcomCompatBundle as dependency
[MidcomCompatBundle] git=git://github.com/bergie/MidgardMidcomCompatBundle.git target=Midgard/MidcomCompatBundle
Install with $ php bin/vendors install
Enable in app/AppKernel.php
$bundles = array( ... new Midgard\MidcomCompatBundle\MidgardMidcomCompatBundle() );
Install Flack's version of MidCOM
$ git clone https://github.com/flack/openpsa.git
Copy schemas from openpsa/schemas to MgdSchema dir
app/config/config.yml
midgard_midcom_compat: root: "%kernel.root_dir%/../openpsa/lib"
framework: templating: { engines: ['twig', 'midcom'] }
Run $ php app/console midgard:connection:init
Enable component in app/AppKernel.php
$bundles = array( ... new Midgard\MidcomCompatBundle\Bundle\ComponentBundle( 'net.nehmer.blog') );
Add a component to routing configuration:
NetNehmerBlog: resource: "net.nehmer.blog" type: midcom prefix: /blog
http://localhost:8001/blog/
Loading a layout for your MidCOM views
app/config/config.yml
midgard_midcom_compat: layout: "MidgardMidcomCompatBundle::layout.html.twig"
Some areas to follow:
• Symfony CMF: node-based routing, etc• PHPCR: standard content repository APIs• MidCOM and Midgard MVC compat work
Photos:http://www.flickr.com/photos/bfs_man/4939624151/http://www.flickr.com/photos/jeremyhiebert/5105804864/http://www.flickr.com/photos/donkeyhotey/5527263186/http://www.flickr.com/photos/eustaquio/2750429774/http://www.flickr.com/photos/hatwar/5022365448/http://www.flickr.com/photos/jordanfischer/72510316/http://www.flickr.com/photos/bellatrix6/130907944/
Inspiration:http://www.slideshare.net/weaverryan/handson-with-the-symfony2-framework