Il file di configurazione view.yml

Il livello della vista può essere configurato modificando il file di configurazione ~view.yml~.

Come accennato nell'introduzione, il file view.yml beneficia del meccanismo di configurazione a cascata, e può includere delle costanti.

Questo file di configurazione è per lo più deprecato a favore di helper usati direttamente nei template o di metodi chiamati dalle azioni.

Il file di configurazione view.yml contiene un elenco di configurazioni della vista:

---
NOME_VISTA_1:
  # configurazione

NOME_VISTA_2:
  # configurazione

# ...

Il file di configurazione view.yml viene messo in cache come file PHP; tale processo è gestito autonomamente dalla classe ~sfViewConfigHandler~.

Layout

Configurazione predefinita:

---
default:
  has_layout: true
  layout:     layout

Il file di configurazione view.yml definisce il ~layout~ predefinito usato dall'applicazione. Per impostazione predefinita, il nome è layout, quindi symfony decora ogni pagina con il file layout.php, che si trova nella cartella templates/ dell'applicazione. Si può anche disabilitare del tutto il processo di decorazione impostando la voce ~has_layout~ a false.

Il layout viene disabilitato automaticamente per le richieste XML HTTP e per tutti i tipi di contenuto che non siano HTML, a meno che non sia specificato diversamente in modo esplicito.

Fogli di Stile

Configurazione Predefinita:

---
default:
  stylesheets: [main.css]

La voce stylesheets definisce un array di fogli di stile da usare per la vista corrente.

L'inclusione dei fogli di stile definiti in view.yml può essere fatta manualmente con l'helper include_stylesheets().

Se si definiscono diversi file, symfony li includerà nello stesso ordine in cui sono definiti:

---
stylesheets: [main.css, foo.css, bar.css]

Si può anche cambiare l'attributo media oppure omettere il suffisso .css:

Questa impostazione è deprecata in favore dell'helper use_stylesheet():

<?php use_stylesheet('main.css') ?>
 

Nel file di configurazione predefinito view.yml, il file riferito è main.css e non /css/main.css. Di fatto, entrambe le definizioni sono equivalenti, poiché symfony aggiunge /css/ ai percorsi relativi.

JavaScript

Configurazione Predefinita:

---
default:
  javascripts: []

La voce javascripts definisce un array di file JavaScript da usare per la vista corrente.

L'inclusione dei file JavaScript definiti in view.yml può essere fatta manualmente con l'helper include_javascripts().

Se si definiscono diversi file, symfony li includerà nello stesso ordine in cui sono definiti:

---
javascripts: [foo.js, bar.js]

Si può anche omettere il suffisso .js:

---
javascripts: [foo, bar]

Questa impostazione è deprecata in favore dell'helper use_javascript():

<?php use_javascript('foo.js') ?>
 

Se si usano percorsi relativi, come foo.js, symfony aggiunge /js/ all'inizio.

Meta e HTTP Meta

Configurazione Predefinita:

---
default:
  http_metas:
    content-type: text/html

  metas:
    #title:        symfony project
    #description:  symfony project
    #keywords:     symfony, project
    #language:     en
    #robots:       index, follow

Le impostazioni http_metas e metas consentono di definire dei meta tag da includere nel layout.

L'inclusione dei meta tag definiti in view.yml può essere fatta manualmente con gli helper include_metas() e include_http_metas().

Queste impostazioni sono deprecate in favore dell'uso di puro HTML nel layout, per i meta statici (come il content-type) o in favore di uno slot, per i meta dinamici (come il titolo o la descrizione).

Se ha senso, il meta HTTP content-type è modificato automaticamente per includere il set di caratteri definito nel file di configurazione settings.yml, se non è già presente.