|
|
The symfony Reference BookIl file di configurazione settings.yml |
|
You are currently reading "The symfony Reference Book" which is licensed under the Creative Commons Attribution-Share Alike 3.0 Unported License license.
.actions error_404 login secure module_disabled .settings escaping_strategy escaping_method csrf_secret charset enabled_modules default_timezone cache etag i18n default_culture standard_helpers no_script_name lazy_cache_key logging_enabled web_debug error_reporting compressed use_database check_lock check_symfony_version web_debug_web_dir strip_comments max_forwards 
|
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License. |
Molti aspetti di symfony possono essere configurati sia tramite file di
configurazione scritti in YAML sia in semplice PHP. In questa sezione viene
descritto il principale file di configurazione per un'applicazione: settings.yml.
Il file di configurazione settings.yml per un'applicazione si trova nella
cartella apps/NOME_APP/config/.
Come anticipato nell'introduzione il file settings.yml è
consapevole dell'ambiente
e beneficia del meccanismo di configurazione a cascata.
Ogni sezione dedicata ad un ambiente ha due sotto sezioni: .actions e .settings.
Tutte le impostazioni vanno inserite nella sotto sezione .settings, eccezion
fatta per le azioni predefinite da visualizzare per alcune pagine comuni.
Il file di configurazione
settings.ymlviene memorizzato in cache come file PHP; questo processo è gestito in modo automatico dalla classesfDefineEnvironmentConfigHandler.
.actions
.settings
cachecharsetcheck_lockcheck_symfony_versioncompressedcsrf_secretdefault_culturedefault_timezoneenabled_moduleserror_reportingescaping_strategyescaping_methodetagi18nlazy_cache_keylogging_enabledno_script_namemax_forwardsstandard_helpersstrip_commentsuse_databaseweb_debugweb_debug_web_dir.actionsConfigurazione predefinita:
default:
.actions:
error_404_module: default
error_404_action: error404
login_module: default
login_action: login
secure_module: default
secure_action: secure
module_disabled_module: default
module_disabled_action: disabled
La sotto sezione .actions definisce che azione eseguire quando è necessario
visualizzare pagine comuni. Ogni definizione ha due componenti: la prima per il
modulo (con suffisso _module) e la seconda per l'azione (con suffisso _action).
error_404L'azione error_404 viene eseguita quando deve essere visualizzata una pagina 404
(pagina non trovata).
loginL'azione login viene eseguita quando un utente non autenticato cerca di accedere
ad una pagina protetta.
secureL'azione secure viene eseguita quando un utente non ha le credenziali richieste.
module_disabledL'azione module_disabled viene eseguita quando un utente invia una richiesta
ad un modulo disabilitato.
.settingsLa sotto sezione .settings è dove si specifica la configurazione del framework.
I paragrafi seguenti descrivono tutte le possibili impostazioni ordinate per
importanza.
Tutte le impostazioni definite nella sezione .settings sono disponibili in qualsiasi
punto del codice, utilizzando l'oggetto sfConfig ed anteponendo al nome dell'impostazione
il prefisso sf_. Per esempio, per ottenere il valore dell'impostazione charset
utilizzare:
sfConfig::get('sf_charset');
escaping_strategyPredefinito: off
L'impostazione escaping_strategy è un valore Booleano che determina se il
sub-framework per l'escape dell'output è abilitato o meno. Quando è abilitato
tutte le variabili disponibili nei template vengono automaticamente sottoposte
all'escape chiamando la funzione di supporto definita nell'impostazione
escaping_method (vedere sotto).
Notare che escaping_method è l'helper predefinito usato da symfony, tuttavia
può essere rimpiazzato di volta in volta (un esempio è l'output di una variabile
in uno script Javascript).
Il sub-framework che si occupa dell'escape dell'output utilizza l'impostazione
charset per il suo compito.
È vivamente consigliato di cambiare il valore predefinito a on.
Queste impostazioni possono essere dichiarate quando si crea un'applicazione con il task
generate:apputilizzando l'opzione--escaping-strategy.
escaping_methodPredefinito: ESC_SPECIALCHARS
L'impostazione escaping_method definisce la funzione predefinita da utilizzare
per l'escape delle variabili nei template (vedere escaping_strategy precedente).
È possibile selezionare uno dei valori proposti: ESC_SPECIALCHARS, ESC_RAW,
ESC_ENTITIES, ESC_JS, ESC_JS_NO_ENTITIES, e
ESC_SPECIALCHARS o creare una nuova funzione.
Per la maggior parte dei casi il valore predefinito è la scelta migliore. Può essere
utilizzato anche l'helper ESC_ENTITIES specialmente se si lavora solamente con
l'inglese o lingue europee.
csrf_secretPredefinito: false
L'impostazione csrf_secret specifica una chiave univoca di sicurezza per
l'applicazione. Se non è impostata a false, attiva la protezione CSRF per
tutti i form generati dal framework dei form. Questa impostazione è utilizzata anche
dall'helper link_to() quando c'è la necessità di convertire un link ad un form
(per simulare un metodo HTTP DELETE per esempio).
È vivamente consigliato di cambiare il valore predefinito con una chiave segreta univoca.
Queste impostazioni possono essere dichiarate quando si crea un'applicazione con il task
generate:apputilizzando l'opzione--csrf-secret.
charsetPredefinito: utf-8
L'impostazione charset specifica il set di caratteri che verrà utilizzato in ogni
situazione dal framework: dall'header di risposta Content-Type alla funzionalità
di escape dell'output.
Il più delle volte il valore predefinito va bene.
Questa impostazione è usata in diversi posti nel framework, quindi il suo valore è messo in cache in molti posti. Dopo averlo cambiato, occorre pulire la cache della configurazione, anche nell'ambiente di sviluppo.
enabled_modulesPredefinito: [default]
L'impostazione enabled_modules è un array dei nomi dei moduli da abilitare
per la specifica applicazione. Moduli definiti in plugin o nel core di symfony
non sono abilitati in modo predefinito e devono quindi essere elencati in questa
impostazione per essere accessibili.
Aggiungere un modulo è solamente questione di aggiungerlo alla lista (l'ordine con cui vengono inseriti non importa):
enabled_modules: [default, sfGuardAuth]
Il modulo default definito nel framework contiene tutte le azioni predefinite
impostate nella sotto sezione .actions del file settings.yml. Raccomandiamo
di personalizzare tutte le impostazioni e quindi rimuovere il modulo default
da questa configurazione.
default_timezonePredefinito: none
L'impostazione default_timezone definisce il fuso orario predefinito usato
da PHP. Può essere un qualsiasi fuso orario
riconosciuto da PHP.
Se non viene definito nessun fuso orario, verrà chiesto di definirne uno nel file
php.ini. Altrimenti, symfony cercherà di indovinare il migliore fuso orario applicabile utilizzando la funzione PHPdate_default_timezone_get().
cachePredefinito: off
L'impostazione cache abilita o meno la cache dei template.
La configurazione generale del sistema della cache viene specificata nelle sezioni
view_cache_managereview_cachedel filefactories.yml. La configurazione dettagliata viene fatta nel file di configurazionecache.yml.
etagPredefinito: on ad esclusione degli ambienti dev e test
L'impostazione etag abilita e disabilita la generazione automatica degli header
HTTP ETag. L'ETag generato da symfony è un semplice md5 del contenuto della
risposta.
i18nPredefinito: off
L'impostazione i18n è un valore Booleano che abilita e disabilita il
sub-framework i18n. Se l'applicazione è internazionalizzata impostarlo a on.
La configurazione generale del sistema i18n va indicata nella sezione
i18ndel file di configurazionefactories.yml.
default_culturePredefinito: en
L'impostazione default_culture definisce la nazionalità predefinita utilizzata
dal sub-framework i18n. Può essere una qualsiasi delle nazionalità valide.
standard_helpersPredefinito: [Partial, Cache, Form]
L'impostazione standard_helpers è un array di gruppi di helper da caricare
per tutti i template (nome del gruppo di helper senza il suffisso Helper).
no_script_namePredefinito: on per l'ambiente prod della prima applicazione creata,
off per tutte le altre
L'impostazione no_script_name determina il fatto che il nome del front controller
venga inserito o meno negli URL generati. In modalità predefinita è impostato a on dal
task generate:app per l'ambiente prod della prima applicazione creata.
Ovviamente solo un'applicazione e ambiente può avere questa impostazione impostata
a on se tutti i front controller sono nella stessa cartella (web/). Se fosse
necessario avere più di un'applicazione con no_script_name impostato a on,
è necessario spostare i front controller corrispondenti in una sotto cartella
della cartella web principale.
lazy_cache_keyPredefinito: on per i nuovi progetti, off per progetti aggiornati
Quando abilitata l'impostazione lazy_cache_key ritarda la creazione di una chiave
cache fino a che non verrà verificato se l'azione o il partial può essere inserito
in cache o meno.
Questa impostazione è stata introdotta in symfony 1.2.7 per aumentare le prestazioni senza inficiare la retrocompatibilità con le versioni precedenti alla 1.2. Verrà rimossa in symfony 1.3, in quanto l'ottimizzazione sarà sempre abilitata.
Questa impostazione è disponibile solo per symfony 1.2.7 e superiori.
logging_enabledPredefinito: on per tutti gli ambienti escluso prod
L'impostazione logging_enabled abilita il sub-framework dei log. Impostandola
a false, si aggira completamente il meccanismo di log e si ottiene un piccolo
guadagno in termini di prestazioni.
La configurazione fine del sistema dei log deve essere fatta nel file di configurazione
factories.yml.
web_debugPredefinito: off per tutti gli ambienti escluso dev
L'impostazione web_debug abilita la web debug toolbar. La web debug toolbar
viene inserita in una pagina quando il content type della risposta è HTML.
error_reportingPredefinito:
prod: E_PARSE | E_COMPILE_ERROR | E_ERROR | E_CORE_ERROR | E_USER_ERRORdev: E_ALL | E_STRICTtest: (E_ALL | E_STRICT) ^ E_NOTICEL'impostazione error_reporting controlla il livello dell'error reporting di
PHP (da visualizzare nel browser o da scrivere nei log).
Sul sito ufficiale di PHP si possono trovare alcune informazioni su come utilizzare gli operatori logici.
La configurazione predefinita è la più sensibile e non dovrebbe essere modificata.
La visualizzazione degli errori nel browser è disabilitata automaticamente per i front controller che hanno disabilitato il
debug, questo è il caso predefinito per l'ambienteprod.
compressedPredefinito: off
L'impostazione compressed abilita la compressione nativa di PHP delle risposte.
Se impostato a on symfony utilizzerà ob_gzhandler
come funzione di callback per ob_start().
È raccomandabile tenere questo valore a off ed utilizzare invece il meccanismo
di compressione nativo del web server utilizzato.
use_databasePredefinito: on
L'impostazione use_database determina se l'applicazione utilizza o meno un
database.
check_lockPredefinito: off
L'impostazione check_lock abilita e disabilita il sistema di lock di un'applicazione
azionato da alcuni task come cache:clear e project:disable.
Se impostato a on tutte le richieste verso applicazioni disabilitate verranno
automaticamente redirette alla pagina lib/exception/data/unavailable.php
messa a disposizione dal core di symfony.
È possibile sovrascrivere il template predefinito aggiungendo un file
config/unavailable.phpal progetto o all'applicazione.
check_symfony_versionPredefinito: off
L'impostazione check_symfony_version abilita e disabilita il controllo della
versione corrente di symfony eseguito ad ogni richiesta. Se abilitato symfony
pulirà la cache in modo automatico quando il framework verrà aggiornato.
È vivamente sconsigliato di impostare questo valore su on, dato che aggiunge
un leggero overhead e perché è veramente semplice ripulire la cache quando si
esegue il deploy di un nuovo progetto. Questa impostazione è utile solamente
quando molti progetti condividono lo stesso codice symfony, cosa che comunque
non è raccomandata.
web_debug_web_dirPredefinito: /sf/sf_web_debug
L'impostazione web_debug_web_dir definisce il percorso per i file della
web debug toolbar (immagini, fogli di stile e file JavaScript).
strip_commentsPredefinito: on
L'impostazione strip_comments determina se symfony può ignorare i commenti quando
compila le classi del core. Questa impostazione viene utilizzata solamente se
l'impostazione debug è impostata a off.
Se si verificano pagine bianche solamente nell'ambiente di produzione provare ad
impostare il valore a off.
max_forwardsPredefinito: 5
L'impostazione max_forwards definisce il massimo numero di forward interni
permessi prima che symfony generi un'eccezione. Questo serve per prevenire loop
infiniti.
If you find a typo or an error, please register and open a ticket.
If you need support or have a technical question, please post to the official user mailing-list.
