From Tlalokes

Contents 1 Requerimientos 2 Descarga 3 Instalación 3.1 El framework 3.2 La aplicación 3.3 El área pública 3.4 Instalador web

Requerimientos

• Apache web server con mod_rewrite (otros servidores de web no están documentados aún).
• PHP 5.2.x o superior (Soporta 5.3.x)
• Las siguientes bases de datos están actualmente soportadas (deberás tener instalada la extensión correspondiente al manejador de base de datos a usar):
  • PostgreSQL
  • MySQL
  • SQLite
  • ODBC
  • Oracle
  • MS SQL Server

en futuras versiones se soportará PDO para el ORM

Descarga

Descarga el framework.

• La versión estable desde el sitio web de Tlalokes ya sea en formato ZIP o BZIP2.
• La versión de desarrollo desde el repositorio en gitorious.

$ git clone http://git.gitorious.org/tlalokes/framework.git TlalokesFramework

Instalación

Antes de instalar es importante tener en cuenta que Tlalokes distribuye el trabajo en tres directorios, a saber, el framework, la aplicación y el área pública.

El framework

1. Si lo has bajado, descomprime el framework en la ubicación de tu preferencia.
2. Estructura. Su estructura es la siguiente:

example - Contiene archivos de ejemplo para el área publica de un sito que utilice el framework
tlalokes - Contiene las clases y funciones base del framework
lib - Contiene las bibliotecas de terceros utilizadas por el framework
builders - Contiene scripts PHP que pueden ser utilizados para generar aplicaciones.

La aplicación

Es el espacio donde se ubicará el código fuente de tu aplicación.

1. Crea el directorio de tu aplicación asignandole el nombre y ubicación de tu preferencia, procurando evitar el uso de espacios en blanco y preferentemente utilizando solo minúsculas y guiones bajos.
2. Si utilizas GNU/Linux u otro sistema operativo tipo UNIX realiza lo siguiente:

Si te es posible, asigna como propietario del directorio de la aplicación al usuario propietario del servidor de web.

# chown www-data directorio_aplicacion

de lo contrario asigna los siguientes permisos de escritura

$ chmod 757 directorio_aplicacion

El área pública

Se denomina área pública al directorio asignado en el servidor web para la publicación de contenido, por ejemplo, en el caso del servidor web Apache sería el denominado como htdocs.

1. Crea un directorio dentro del área pública de tu servidor de web.
2. Copia en tú recién creado directorio, el contenido del directorio example que se encuentra ubicado dentro de la estructura del framework.
3. Modifica el archivo index.php
   1. Edita las tres variables del archivo index.php
      • $tlalokes. Coloca en esta variable la ubicación absoluta del framework.
      • $application. Coloca en esta variable la ubicación absoluta de tu aplicación.
      • $uri. Coloca en esta variable la ubicación relativa pública de tu sitio web. Ejemplo: /sitio/
   2. Guarda los cambios realizados.
4. Abre la ubicación relativa pública de tu sitio web en tu navegador, se recomienda el uso de Mozilla Firefox.

Instalador web

Una vez cargado tu sitio web en el navegador podrás utilizar el instalador web de Tlalokes, realizando los siguientes pasos:

1. Licencia. Lee la licencia del framework, y si estás de acuerdo con sus términos aceptalos haciendo click en el botón Accept.
2. Configuración.
   1. Llave o contraseña de la aplicación. Ingresa una contraseña para tu aplicación y confirmala. Esta te servirá posteriormente para poder ejecutar los constructores (builders) encargados de generar código para tu aplicación.
   2. Zona horaria. A partir de PHP 5.3.x se require especificar la zona horaria.
   3. Base de datos. Si tu aplicación hará uso de una base de datos, activa esta configuración y completa el formulario proporcionando el manejador de base de datos que utilizarás, el nombre del host, el nombre de la base de datos, el usuario y contraseña de acceso a la base de datos.
   4. Finalmente haz click en Save.
3. La estructura de tu aplicación será generada, una vez realizado esto puedes comenzar a configurar tu aplicación.