Symfony2, tutorial para comenzar ultra-rápido

This post in english at http://en.mooontes.com/2011/03/27/symfony2-ultra-fast-start-tutorial/

NOTA: Este tutorial se ha realizado en Ubuntu 11.04 – Natty Narwhal, no se ha comprobado su funcionamiento en otros sistemas operativos. Esto es sólo una especie de chuleta de ejemplo por si se te olvida alguna cosa tras leer la documentación de symfony2, pero evidentemente es imprescindible leérsela antes para saber de qué va todo esto http://symfony.com/doc/2.0/book/index.html

El código fuente utilizado está disponible en: https://github.com/montes/Adictos-Symfony2-Bundle

ACTUALIZACIÓN 23/5/2011: Actualizado para symfony2 beta2

1. Descarga

Descarga Symfony2 Standard Edition (en el momento de escribir esto la BETA2): http://symfony.com/download

Descomprime

tar -zxvf Symfony_Standard_Vendors_2.0.0BETA2.tgz

Y cambia los permisos de app/cache y app/logs para que sean escribibles por php, por ejemplo:

chmod 777 app/cache app/logs

Configura en tu servidor el directorio “web/” como raíz y ya deberías poder cargar la página de bienvenida de symfony2 desde http://127.0.0.1/app_dev.php/

2. Configura la base de datos

Configura app/config/parameters.ini con las opciones de tu base de datos (también lo puedes hacer desde http://127.0.0.1/app_dev.php/_configurator/ ), para mysql sería algo así:

[parameters]
    database_driver=pdo_mysql
    database_host=localhost
    database_name=symfony2
    database_user=symfony2
    database_password=password
    mailer_transport=smtp
    mailer_host=localhost
    mailer_user=
    mailer_password=
    locale=en
    csrf_secret=op234j234j2424jojpfwesdcsdc

3. Crear nuestro primer bundle

Ahora ya podemos crear un bundle:

php app/console init:bundle "Montes\AdictosBundle" src

Ahora toca añadir a app/autoload.php :

$loader->registerNamespaces(array(
    'Montes'                         => __DIR__.'/../src',
    // ...
));

y añadir a app/AppKernel.php :

    $bundles = array(
        // ...
        new Montes\AdictosBundle\MontesAdictosBundle(),
    );

4. Ruta

Para que symfony2 sepa dónde enviar las peticiones, añadimos a app/config/routing_dev.yml :

homepage:
    pattern:  /adictos
    defaults: { _controller: MontesAdictosBundle:Default:index }

En este punto ya podemos cargar nuestro recién creado bundle yendo a: http://127.0.0.1/app_dev.php/adictos

5. Controller

El controller por defecto (Montes/AdictosBundle/Controller/DefaultController.php) ya nos lo ha creado Symfony2, ahora vamos a crear el controller StoreController.php

//Montes/AdictosBundle/Controller/StoreController.php
<?php

namespace Montes\AdictosBundle\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;

class StoreController extends Controller
{
    /**
     * @Template()
     */
    public function indexAction($store)
    {
        return array('store' => $store);
    }
}

y añadimos a app/config/routing_dev.yml

store:
    pattern: /adictos/{store}
    defaults: { _controller: MontesAdictosBundle:Store:index }

y una nueva plantilla de twig a Montes/AdictosBundle/Resources/Views/Store/index.html.twig

So you want store "{{ store }}"?

Y ahora cargando http://127.0.0.1/app_dev.php/adictos/mi-tienda obtendremos:

So you want store “mi-tienda”?

6. Modelo

NOTA: Para entrar en detalle sobre Doctrine2 recomiendo el blog de Francisco Belmonte, una maravilla.

Primero añadimos a app/config/config.yml “MontesAdictosBundle: ~“ A partir de la BETA1 por defecto el mapping es automático.

Comenzamos con Doctrine, vamos a definir nuestro modelo para una tienda. Antes de nada, como aún no hemos creado ningún modelo tendremos que crear el directorio Montes/AdictosBundle/Entity que es donde los guardaremos todos.

Y ya podemos empezar, modelo para Store:

<?php
// Montes/AdictosBundle/Entity/Store.php

namespace Montes\AdictosBundle\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Store
{
    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     * @ORM\GeneratedValue(strategy="AUTO")
     */
     protected $id;

    /**
     * @ORM\ManyToMany(targetEntity="Category")
     * @ORM\JoinTable(name="stores_categories",
     *      joinColumns={@ORM\JoinColumn(name="store_id", referencedColumnName="id")},
     *      inverseJoinColumns={@ORM\JoinColumn(name="category_id", referencedColumnName="id")})
     */
    protected $categories;

    /**
     * @ORM\Column(type="string", length="255")
     */
    protected $url;

    /**
     * @ORM\Column(type="string", length="255")
     */
    protected $name;

    /**
     * @ORM\Column(type="integer")
     */
    protected $clicks = 0;

    /**
     * @ORM\Column(type="boolean")
     */
    protected $validated = false;

    /**
     * @ORM\Column(type="integer")
     */
    protected $pcomments = 0;

    /**
     * @ORM\Column(type="integer")
     */
    protected $ncomments = 0;

    /**
     * @ORM\Column(type="boolean")
     */
    protected $active = false;

    /**
     * @ORM\Column(type="datetime", name="updated_at")
     */
    protected $updatedAt;

    /**
     * @ORM\Column(type="datetime", name="created_at")
     */
    protected $createdAt;

    public function __construct()
    {
        $this->categories = new \Doctrine\Common\Collections\ArrayCollection();
        $this->createdAt = new \DateTime();
        $this->updatedAt = new \DateTime();
    }
}

Modelo para Category:

<?php
// Montes/AdictosBundle/Entity/Category.php

namespace Montes\AdictosBundle\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Category
{
    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     * @ORM\GeneratedValue(strategy="AUTO")
     */
    protected $id;

    /**
     * @ORM\OneToMany(targetEntity="Category", mappedBy="parent")
     */
    protected $children;

    /**
     * @ORM\ManyToOne(targetEntity="Category", inversedBy="children")
     * @ORM\JoinColumn(name="parent_id", referencedColumnName="id")
     * @ORM\Column(nullable="true")
     */
    protected $parent;

    /**
     * @ORM\ManyToMany(targetEntity="Store", mappedBy="categories")
     */
    protected $stores;

    /**
     * @ORM\Column(type="string", length="255")
     */
    protected $name;

    /**
     * @ORM\Column(type="string", length="255", name="url_string", unique="true")
     */
    protected $urlString;

    public function __construct()
    {
        $this->stores = new \Doctrine\Commmon\Collections\ArrayCollection();
    }
}

Y ahora vamos a consola y para generar las tablas en la base de datos ejecutamos:

php app/console doctrine:schema:create

y para completar nuestro modelo con sus getters/setters:

php app/console doctrine:generate:entities MontesAdictosBundle

7. Probando el modelo

Vamos a cambiar la acción que muestra la tienda a su propia acción (storeAction) para hacer hueco al índice del store controller en indexAction, que ahora mostrará el total de tiendas que tenemos almacenadas en la BD.

# app/config/routing_dev.yml
store:
    pattern: /adictos/{store}
    defaults: { _controller: MontesAdictosBundle:Store:store }

store_index:
    pattern: /adictos/
    defaults: { _controller: MontesAdictosBundle:Store:index }

<?php
// Montes/AdictosBundle/Controller/StoreController.php

namespace Montes\AdictosBundle\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;

class StoreController extends Controller
{

    /**
     * @Template()
     */
    public function indexAction()
    {
        $em = $this->get('doctrine.orm.entity_manager');
        $stores = $em->createQuery('SELECT count(s.id) AS total FROM Montes\AdictosBundle\Entity\Store s')->getSingleScalarResult();
        return array('stores' => $stores);
    }

    /**
     * @Template()
     */
    public function storeAction($store)
    {
        return array('store' => $store);
    }
}

<!-- Montes/AdictosBundle/Resources/views/Store/index.html.twig -->
We have a total of {{ stores }} stores.

<!-- Montes/AdictosBundle/Resources/views/Store/store.html.twig -->
So you want store "{{ store }}"?

Ahora al cargar http://127.0.0.1/app_dev.php/adictos/ nos saldrá We have a total of 0 stores y al cargar http://127.0.0.1/app_dev.php/adictos/mi-tienda nos saldrá So you want store “mi-tienda”?

About Montes