Configuración

From Tlalokes

Jump to: navigation, search

Una vez instalado el framework y generada la estructura de tu aplicación, el siguiente paso es configurarla, para ello se edita el archivo config.php ubicado en el directorio de tu aplicación.

Contents

Ejemplo

Un ejemplo de un archivo de configuración sería el siguiente: 

$c['key'] = 'c20ad4d76fe97759aa27a0c99bff6710';
$c['path']['controllers'] = 'control/';
$c['path']['views']       = 'view/';
$c['path']['model']       = 'model/';
$c['path']['bss']         = 'model/business/';
$c['path']['def']         = 'model/dbo/def/';
$c['path']['orm']         = 'model/dbo/orm/';
$c['path']['tmp']         = '_tmp/';
$c['path']['tpl_compile'] = '_tmp/compile/';
$c['path']['tpl_cache']   = '_tmp/cache/';
$c['path']['locales']     = '_locale/';
$c['path']['libs']        = 'lib/';
$c['path']['core']        = 'core/';
$c['default']['controller'] = 'Test';
$c['default']['locale']     = 'eng';
$c['default']['charset']    = 'UTF-8';
$c['mode']['smarty'] = 'production';
$c['mode']['propel'] = 'production';
$c['dsn']['type'] = 'mysql';
$c['dsn']['host'] = 'localhost';
$c['dsn']['name'] = 'test';
$c['dsn']['username'] = 'foo';
$c['dsn']['password'] = 'bar';
$c['execute']['crud_propel_smarty'] = false;
$c['execute']['auth_propel'] = false;
//$c['auth'] = 'db';

Descripción

Llave

La llave permite contar con cierto nivel de seguridad respecto del acceso al ejecutor de Tlalokes, este se deberá colocar en el URI de la aplicación para validar que la persona que intenta ejecutar es la misma que tiene acceso al archivo de configuración.

El contenido de la llave es un hash md5, ejemplo: 

$c['key'] = 'c20ad4d76fe97759aa27a0c99bff6710';

Ubicaciones (Paths)

Se sugiere no cambiar estas ubicaciones.

  • Aplicación En esta área se especifican las ubicaciones dentro de la aplicación:

Controladores 

$c['path']['controllers'] = 'control/';

Vistas 

$c['path']['views'] = 'view/';

Modelos 

$c['path']['model'] = 'model/';

Componente de lógica de negocio 

$c['path']['bss'] = 'model/business/';

Objetos Definición 

$c['path']['def'] = 'model/dbo/def';

Idiomas 

$c['path']['locales'] = '_locale';
  • Framework En esta área se especifican las ubicaciones dentro del framework:

Bibliotecas 

$c['path']['libs'] = 'lib/';

Elementos por defecto (Defaults)

En esta área se especifican los elementos a utilizar por defecto, tales como: el controlador, idioma y conjunto de carácteres a utilizar.

Controlador 

$c['default']['controller'] = 'Test';

Idioma 

$c['default']['locale'] = 'eng';

Conjunto de carácteres (charset)

Los charsets disponibles son:

  • UTF-8
  • ISO-8859-1
  • ISO-8859-15
  • cp866
  • cp1251
  • cp1252
  • KOI8-R
  • BIG5
  • GB2312
  • BIG5-HKSCS
  • Shift_JIS
  • EUC-JP

se recomienda utilizar UTF-8 

$c['default']['charset'] = 'UTF-8';

Modos (Mode)

Smarty. Tlalokes incluye el motor de plantillas Smarty, que puede utilizarse desde las acciones de un controlador. 

$c['mode']['smarty'] = 'production';

Se proporcionan dos modos: debug y production.

  • debug. Convierte el archivo de plantilla de formato Smarty en código HTML/PHP durante cada ejecución, útil al desarrollar y probar plantillas.
  • production. Pasa por alto la conversión de formato y utiliza las plantillas HTML/PHP previamente procesadas.

Propel. Tlalokes incluye Propel, un toolkit para mapeo objeto-relacional (ORM). Tlalokes permite utilizarlo de una manera sencilla mediante modos configurables. 

$c['mode']['propel'] = 'production';

Los modos son los siguientes:

  • production. Una vez generado el código de acceso a datos es importante usar este modo para evitar sobreescritura de código o de las tablas.
  • build-all. Analiza los objetos definición, escribe la configuración necesaria, genera las tablas en la base de datos y produce el código para el acceso a datos.
  • build-conf. Genera la configuración necesaria para Propel.
  • build-tables. Genera las tablas en la base de datos.
  • build-from-db. Analiza la información de una base de datos existente, escribe los objetos definición, genera la configuración, y produce el código para el acceso a datos.
  • build-om. Analiza los objetos definición y genera el código para el acceso a datos.

Nombre de origen de datos (Data Source Name)

Sistema de manejo de base de datos (RDMBS)

Los RDBMS soportados son:

  • pgsql - PostgrSQL
  • mysql - MySQL
  • mysqli - MySQLi
  • sqlite - SQLite
  • odbc - ODBC
  • oracle - Oracle
  • mssql - MS SQL Server 
$c['dsn']['type'] = 'mysql';

Nombre del host 

$c['dsn']['host'] = 'localhost';

Nombre de la base de datos 

$c['dsn']['name'] = 'test';

Nombre de usuario 

$c['dsn']['username'] = 'foo';

Password de usuario 

$c['dsn']['password'] = 'bar';

Configuración de constructores

Tlalokes utiliza un mecánismo denominado Builders (Constructores) que permite generar código a partir de objetos definición u otros elementos. Tlalokes proporciona algunos builders por default, por ejemplo el crud_propel_smarty que genera código Modelo, Vista, Controlador e Idioma para obtener catálogos CRUD (Create Read Edit Delete) a partir de los Objetos Definición de la aplicación utilizando Propel y Smarty.

Para activar un builder basta con incluir su nombre dentro del nodo execute y asignarle el valor booleano true, por ejemplo: 

$c['execute']['crud_propel_smarty'] = true;

Para desactivarlo e impedir su ejecución solo es necesario cambiar el valor booleano a false, por ejemplo: 

$c['execute']['crud_propel_smarty'] = false;

Si creases tu propio builder para activarlo solo requerieres añadirlo a la configuración 

$c['execute']['mi_propio_builder'] = true;

Para ejecutar un builder solo abre en tu navegador web el URI de tu sitio añadiendo /exe/load al mismo. Ejemplo: 

http://example.org/mi_sitio/exe/load

El ejecutor de builder requiere que la llave o contraseña que se le proporciono al instalar .

Enlaces externos

Retrieved from "http://wiki.tlalokes.org/index.php/Configuraci%C3%B3n"