Ver índice de contenidos del libro

4.5. Configurando la aplicación

La aplicación está formada por una colección de bundles que representan todas las características y capacidades de tu aplicación. Cada bundle se puede personalizar a través de archivos de configuración escritos en YAML, XML o PHP. De forma predeterminada, el archivo de configuración principal se encuentra en el directorio app/config/ y se llama config.yml, config.xml o config.php en función del formato que prefieras:

# app/config/config.yml
imports:
    - { resource: parameters.yml }
    - { resource: security.yml }

framework:
    secret:          "%secret%"
    router:          { resource: "%kernel.root_dir%/config/routing.yml" }
    # ...
 
# Twig Configuration
twig:
    debug:            "%kernel.debug%"
    strict_variables: "%kernel.debug%"
 
# ...
<!-- app/config/config.xml -->
<imports>
    <import resource="parameters.yml" />
    <import resource="security.yml" />
</imports>
 
<framework:config secret="%secret%">
    <framework:router resource="%kernel.root_dir%/config/routing.xml" />
    <!-- ... -->
</framework:config>
 
<!-- Twig Configuration -->
<twig:config debug="%kernel.debug%" strict-variables="%kernel.debug%" />
 
<!-- ... -->
$this->import('parameters.yml');
$this->import('security.yml');
 
$container->loadFromExtension('framework', array(
    'secret'          => '%secret%',
    'router'          => array(
        'resource' => '%kernel.root_dir%/config/routing.php'
    ),
    // ...
));
 
// Configuración Twig
$container->loadFromExtension('twig', array(
    'debug'            => '%kernel.debug%',
    'strict_variables' => '%kernel.debug%',
));
 
// ...

Nota Aprenderás cómo cargar cada archivo y formato en la siguiente sección dedicada a los entornos de ejecución.

Cada opción de nivel superior como framework o twig define la configuración de un bundle específico. Por ejemplo, la clave framework define la configuración para el núcleo de Symfony FrameworkBundle e incluye la configuración de enrutamiento, plantillas, y otros elementos del núcleo.

No te preocupes por el momento de las opciones de configuración específicas de cada sección, ya que el archivo de configuración viene con parámetros predeterminados. A medida que leas y explores más cada parte de Symfony2, aprenderás sobre las opciones de configuración específicas de cada característica.

Formatos de configuración A lo largo de los capítulos, todos los ejemplos de configuración muestran los tres formatos (YAML, XML y PHP). Cada uno tiene sus propias ventajas y desventajas. Tú eliges cual utilizar:

  • YAML: sencillo, limpio y fácil de leer.
  • XML: más poderoso que YAML y permite el autocompletado del IDE.
  • PHP: el más potente, pero menos fácil de leer que los formatos de configuración estándar.

4.5.1. Obteniendo la configuración por defecto

El nuevo comando config:dump-reference te permite volcar a la consola toda la configuración por defecto de un bundle en formato YAML. El siguiente ejemplo muestra cómo volcar la configuración del bundle FrameworkBundle:

$ app/console config:dump-reference FrameworkBundle

En vez de el nombre completo del bundle, también puedes utilizar el nombre de su opción de configuración principal:

$ app/console config:dump-reference framework