Installazione¶

Scaricare il bundle e metterlo sotto lo spazio dei nomi Sensio\Bundle\. Quindi, come per ogni altro bundle, includerlo nella propria classe Kernel:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

public function registerBundles()
{
    $bundles = array(
        ...

        new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(),
    );

    ...
}

Configurazione¶

Tutte le caratteristiche fornite dal bundle sono abilitate in modo predefinito alla registrazione del bundle stesso nella propria classe Kernel.

La configurazione predefinita è la seguente:

Si possono disabilitare alcune annotazioni e convenzioni, definendo una o più impostazioni come false.

Annotazioni per i controllori¶

Le annotazioni sono un bel modo per configurare facilmente i proprio controllori, dalle rotte alla configurazione della cache.

Anche se le annotazioni non sono una caratteristica nativa di PHP, hanno comunque molti vantaggi rispetto ai metodi classici di configurazione di Symfony2:

• Il codice e la configurazione sono nello stesso posto (la classe del controllore);
• Semplici da imparare e da usare;
• Concise da scrivere;
• Rendono snello il controllore (lasciandogli solo la responsabilità di prendere i dati dal modello).

Il bundle definisce le seguenti annotazioni:

Questo esempio mostra tutte le annotazioni disponibili in azione:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Cache;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Method;

/**
 * @Route("/blog")
 * @Cache(expires="tomorrow")
 */
class AnnotController extends Controller
{
    /**
     * @Route("/")
     * @Template
     */
    public function indexAction()
    {
        $posts = ...;

        return array('posts' => $posts);
    }

    /**
     * @Route("/{id}")
     * @Method("GET")
     * @ParamConverter("post", class="SensioBlogBundle:Post")
     * @Template("SensioBlogBundle:Annot:post.html.twig", vars={"post"})
     * @Cache(smaxage="15")
     */
    public function showAction(Post $post)
    {
    }
}

Poiché il metodo showAction segue alcune convenzioni, si possono omettere alcune annotazioni:

1
2
3
4
5
6
7

/**
 * @Route("/{id}")
 * @Cache(smaxage="15")
 */
public function showAction(Post $post)
{
}