YuppConfig

core/config/core.config.YuppConfig.class.php

YuppConfig contiene toda la configuración de Yupp Framework. Aquí se configura la conexión a la base de datos y el modo de ejecución del framework. A continuación se describen las opciones.

Configuración de la base de datos

Para configurar los datos de acceso a la base de datos se debe usar el campo $default_datasource, donde se establece una configuración del motor de bases de datos para cada modo de ejecución.

Para especificar que motor de base de datos se usará se debe establecer la clave 'type' en una de las siguientes constantes: DB_MYSQL, DB_SQLITE o DB_POSTGRES. A continuación se muestra un ejemplo completo, donde para cada modo de ejecución se selecciona una base de datos distinta (yupp_dev, yupp_prod o yupp_test), todas para MySQL.

private $default_datasource = array(
   self::MODE_DEV  => array(
	 'type'     => self::DB_MYSQL,
	 'url'      => 'localhost',
	 'user'     => 'user',
	 'pass'     => 'pass',
	 'database' => 'yupp_dev'
   ),
   self::MODE_PROD => array(
	 'type'     => self::DB_MYSQL,
	 'url'      => 'localhost',
	 'user'     => 'user',
	 'pass'     => 'pass',
	 'database' => 'yupp_prod'
   ),
   self::MODE_TEST => array(
	 'type'     => self::DB_MYSQL,
	 'url'      => 'localhost',
	 'user'     => 'user',
	 'pass'     => 'pass',
	 'database' => 'yupp_test'
   )
 );

Configuración del modo de ejecución

Yupp Framework tiene 3 modos de ejecución: desarrollo, testing y producción. Los modos que hoy se pueden usar son "desarrollo" y "producción".

Modo desarrollo: Este es el modo que debe estar seleccionado mientras se desarrolla una aplicación. En este modo al acceder al framework al desarrollador le aparece un "escritorio" desde donde puede generar las tablas en la base de datos, ejecutar scripts de bootstrap, acceder a todos los controladores disponibles y ver estadísticas de código.
Modo testing: Este modo aún no está disponible para usar. En el futuro servirá para cuando se quieren lanzar tests automáticos sobre la aplicación y para poder ver los resultados e informes de dichos tests.
Modo producción: En este modo el framework se comporta como si la aplicación se fuera a instalar en un servidor y quedara pronta para ser utilizada por los usuarios. Al acceder al framework muestra la vista configurada por defecto para que el usuario vea, o sea que no ve el escritorio que le aparecía al desarrollador cuando estaba en modo "desarrollo".

Para establecer que modo será usado, se debe asignar una de las siguientes constantes al campo $currentMode.

MODE_DEV (modo desarrollo)
MODE_PROD (modo producción)
MODE_TEST (modo testing)

Desde Yupp Framework v0.3, para aumentar la seguridad, las acciones de gestión (como la creación de tablas o ejecución de tests) que están implementadas en CoreController, no se pueden ejecutar en modo PROD. En caso de querer ejecutar estas acciones, el framework muestra una vista amigable con error "403 Forbidden".

Ruteo por defecto para cada modo de ejecución

Mediante el ruteo por defecto, se le puede indicar al framework qué acción ejecutar al ingresar al framework. Esto sirve especialmente para el modo MODE_PROD, ya que se puede indicar que se ingrese diréctamente a una aplicación determinada, en lugar de mostrar el escritorio de Yupp.

Para determinar la acción que se ejecutará por defecto en cada uno de los modos de ejecución, se usa el campo $modeDefaultMapping. En general los valores para los modos "desarrollo" y "testing" no serán modificados. El siguiente es un ejemplo de cómo se asignan los valores:

private $modeDefaultMapping = array(
   self::MODE_DEV => // Si se desea acceder al administrador de Yupp no se deben modificar los valores.
	 array(
	  'app'  => 'core',
	  'controller' => 'core',
	  'action'     => 'index',
	  'params'     => array()
	 ),
   self::MODE_PROD => // Modificar los valores al poner la aplucacion en produccion.
	 array(
	  'app'  => 'portal',
	  'controller' => 'page',
	  'action'     => 'display',
	  'params'     => array('_param_1'=>'index')
	 ),
   self::MODE_TEST => // Todavia no utilizado.
	 array(
	  'app'  => 'core',
	  'controller' => 'core',
	  'action'     => 'index',
	  'params'     => array()
	 )
);

Configuración de los idiomas disponibles

Esta configuración sirve para las aplicaciones multi-lenguage, y los valores que se especifiquen aquí serán usados por el helper localeChooser para mostrar los idiomas disponibles para seleccionar, y luego de hacer la selección del localeChooser, todos los textos que usen los helpers de i18n serán traducidos automáticamente al idioma seleccionado.

Los lenguajes para seleccionar se especifican en el campo $available_locales. El siguiente es un ejemplo de asignación de valores:

private $available_locales = array("es", "en", "it");