====== Symfony YAML Configuration Reference ======
=====The module.yml configuration file=====

In this article we assume that you are familiar with [[http://www.symfony-project.org/reference/1_4/en/02-YAML|The YAML Format]] and [[http://www.symfony-project.org/reference/1_4/en/03-Configuration-Files-Principles|Configuration File Principles]].

The module.yml configuration file allows the configuration of a module. This file needs to be stored in the config/ sub-directory of a module to be loaded by symfony.

<code yml>
env_name:
  enabled:            <true | false>
  view_class:         view_class_name
  partial_view_class: partial_view_class_name

</code>

=====Module configuration options=====
====env_name====
        
The //module.yml// file is environment-aware, therefore you can add configurations for different environments by specifying environment name (eg.: //prod//, //test//) or '//all//' for all environments.

====env_name > enabled====
        
If the this parameter is set to //false//, all actions of a module are disabled. They are redirected to the //module_disabled_module/module_disabled_action// action (as defined in settings.yml).
Possible values: //<true | false>//
Default: //true//

====env_name > view_class====
        
Defines the view class used by all actions of the module (without the View suffix). It must inherit from sfView.
Default: //sfPHP//

====env_name > partial_view_class====
        
Defines the view class used for partials of the module (without the PartialView suffix). It must inherit from sfPartialView.
Default: //sf//