Altri file di configurazione

Questo capitolo descrive altri file di configurazione, che raramente necessitano di essere cambiati.

autoload.yml

La configurazione autoload.yml determina quali cartelle necessitano di essere autocaricate da symfony. Ogni cartella è scansionata per classi e interfacce PHP.

Come discusso in sede di introduzione, il file autoload.yml trae beneficio dal meccanismo di configurazione a cascata e può includere costanti.

La configurazione predefinita va bene per la maggior parte dei progetti:

autoload:
  # project
  project:
    name:           project
    path:           %SF_LIB_DIR%
    recursive:      true
    exclude:        [model, symfony]
 
  project_model:
    name:           project model
    path:           %SF_LIB_DIR%/model
    recursive:      true
 
  # application
  application:
    name:           application
    path:           %SF_APP_LIB_DIR%
    recursive:      true
 
  modules:
    name:           module
    path:           %SF_APP_DIR%/modules/*/lib
    prefix:         1
    recursive:      true

Ogni configurazione ha un nome e deve essere assegnato con una chiave che ha quel nome. Questo consente di sovrascrivere la configurazione predefinita.

Diverse chiavi possono essere usate per personalizzare il comportamento dell'autocaricamento:

• name: Una descrizione
• path: Il percorso da caricare automaticamente
• recursive: Per cercare le classi PHP nelle sotto-cartelle
• exclude: Un array di nomi di cartelle da escludere nella ricerca
• prefix: true se le classi trovate nel percorso devono essere caricate solo per un dato modulo (valore predefinito false)
• files: Un array di file in cui cercare esplicitamente delle classi PHP
• ext: L'estensione delle classi PHP (valore predefinito .php)

Per esempio, se si incorpora una grossa libreria all'interno del progetto sotto la cartella lib/ e se essa già supporta l'autocaricamento, si può escluderla dal sistema di autocaricamento predefinito di symfony per beneficiare di un aumento delle prestazioni, modificando la configurazione di autocaricamento di project:

autoload:
  project:
    name:           project
    path:           %SF_LIB_DIR%
    recursive:      true
    exclude:        [model, symfony, vendor/large_lib]

config_handlers.yml

Il file di configurazione config_handlers.yml descrive la configurazione usata per gestire le classi usate per analizzare e interpretare tutti gli altri file di configurazione YAML. Di seguito la configurazione predefinita usata per caricare il file di configurazione settings.yml:

config/settings.yml:
  class:    sfDefineEnvironmentConfigHandler
  param:
    prefix: sf_

Ogni file di configurazione è definito da una classe (la chiave class) e può essere ulteriormente personalizzato definendo alcuni parametri sotto la sezione param.

Il file predefinito config_handlers.yml definisce le classi da analizzare come segue:

core_compile.yml

Il file di configurazione core_compile.yml descrive i file PHP che sono uniti in un unico grosso file nell'ambiente prod, per velocizzare il tempo necessario a symfony per caricare. Per impostazione predefinita, le principali classi del nucleo di symfony sono definite in questo file di configurazione. Se l'applicazione si basa su alcune classi che necessitano di essere caricate per ogni richiesta, è possibile creare un file di configurazione core_compile.yml nel progetto o applicazione e aggiungerli a esso. Questo è un estratto della configurazione predefinita:

- %SF_SYMFONY_LIB_DIR%/autoload/sfAutoload.class.php
- %SF_SYMFONY_LIB_DIR%/action/sfComponent.class.php
- %SF_SYMFONY_LIB_DIR%/action/sfAction.class.php
- %SF_SYMFONY_LIB_DIR%/action/sfActions.class.php

Come discusso in sede di introduzione, il file core_compile.yml beneficia del meccanismo di configurazione a cascata e può includere costanti.

module.yml

Il file di configurazione module.yml consente la configurazione di un modulo. Questo file di configurazione è utilizzato raramente e può contenere solo le voci definite di seguito.

Il file module.yml richiede di essere memorizzato nella sotto-cartella config/ di un modulo che deve essere caricato da symfony. Il codice seguente mostra il contenuto tipico di module.yml con i valori predefiniti per tutte le impostazioni:

all:
  enabled:            true
  view_class:         sfPHP
  partial_view_class: sf

Se il parametro enabled è impostato a false, tutte le azioni di un modulo sono disabilitate. Queste vengono reindirizzate all'azione module_disabled_module/module_disabled_action (come definito in settings.yml).

Il parametro view_class definisce la classe vista usata da tutte le azioni del modulo (senza il suffisso View). Essa deve ereditare da sfView.

Il parametro partial_view_class definisce la classe vista usata per i partial di questo modulo (senza il suffisso PartialView). Essa deve ereditare da sfPartialView.