Parte1-Capitulo3

Capitulo 3. Instalación de Kumbia

1. Pre-requisitos

Es necesario instalar el la máquina con Windows 2000/XP/2003 ó Linux/UNIX un servidor Web Apache en cualquier versión. · Puedes utilizar IIS con IsapiRewrite instalado. · Instalar PHP5+ (recomendado 5.2) y algún motor de base de datos soportado si se necesitase (mysql, oracle, postgresql...).

2. Descargar e instalar Kumbia

Kumbia se distribuye en un paquete comprimido listo para usar. Se puede descargar la última versión de http://www.kumbia.org Existen varios tipos de versiones, las versiones en desarrollo ( alpha, beta, ... ) y las versiones estables. Se recomienda usar estas últimas para desarrollos que necesitan que todo sea operativo. Las versiones en desarrollo pueden contener bugs todavia no filtrados y estructuras temporales. El nombre del paquete tiene un nombre como kumbia-version-notes.formato, por ejemplo: kumbia-0.4.7a-stable.tar.gz Se copia el paquete al directorio raíz del servidor web. Windows: c:\Apache2\htdocs\ o c:\wamp\www Linux: /srv/www/htdocs, /var/www/html o /var/www Se descomprime y crea un directorio kumbia-0.5.x que puede ser renombrado por el nombre de nuestro proyecto.

3. Configurando Apache

Kumbia utiliza un módulo llamado modrewrite para la utilización de URLS más entendibles y fáciles de recordar en nuestras aplicaciones. Por esto, el módulo debe ser configurado e instalado en Apache. Para esto, debe chequear que el módulo esté habilitado en el httpd.conf Options Indexes FollowSymLinks AllowOverride All Order allow,deny Allow from all En el DocumentRoot (Directorio Raíz de Apache) debe llevar la opción AllowOverride All para que Apache lea el archivo .htaccess y llame a modrewrite AccessFileName .htaccess LoadModule rewritemodule modules/modrewrite.so Sirven para indicar que el archivo de configuración se llama .htaccess y que suba el módulo modrewrite, esta última línea generalmente aparece con un signo # de comentario. DirectoryIndex index.php index.html ... Indican a Apache que index.php es un archivo de índice que tiene prioridad sobre index.html, es muy importante que index.php esté antes de index.html.

3.1. La importancia de mod-rewrite

ReWrite es un módulo de apache que permite reescribir las urls que han utilizado nuestros usuarios a otras más complicadas para ellos. Kumbia encapsula esta complejidad permitiéndonos usar URLS bonitas o limpias como las que vemos en blogs o en muchos sitios donde no aparecen los ? ó los & o las extensiones del servidor (.php, .asp, .aspx, etc). Además de esto, con mod-rewrite, kumbia puede proteger nuestras aplicaciones ante la posibilidad de que los usuarios puedan ver los directorios del proyecto y puedan acceder a archivos de clases, modelos, lógica, etc, sin que sean autorizados. Con mod-rewrite el único directorio que pueden ver los usuarios es el contenido del directorio public, el resto permanece oculto y sólo puede ser visualizado cuando ha realizado una petición en forma correcta y también es correcto según nuestra lógica de aplicación. Cuando escribes direcciones utilizando este tipo de URLs, estás ayudando también a los motores de búsqueda a indexar mejor tu información.

4. Configurando PHP

La siguiente configuración de PHP es importante para que Kumbia funcione correctamente: shortopentag = On Permiten el uso de etiquetas del tipo magicquotesgpc = On Nos protegen en cierta medida de ataques de inyección SQL que puedan tratar de ejecutar sobre nuestras aplicaciones en Kumbia. errorreporting = EALL & ~ENOTICE Kumbia no está escrito respetando el estándar ESTRICT, por lo que en algunas configuraciones podrían aparecer mensajes inesperados o molestos de parte de PHP. session.savepath = /path/to/dir/ Debe apuntar a un directorio con permisos de escritura trackerrors = On Permite que Kumbia muestre información más precisa sobre algunos warnings y mensajes de error que son controlados internamente.

5. Configurando BB.DD

5.1. MySQL

Cuando se utiliza una base de datos MYSQL5 debe verificarse que el sqlmode no esté en modilidad estricta. Para validar esto debe ingresar a la línea de comando de MYSQL5: mysql -h localhost -u root -p y luego ejecutar el siguiente select: mysql> select @@global.sqlmode; Dependiendo de la configuración que tenga le dará un resultado parecido a esto: +----------------------------------------------- +
| @@global.sqlmode |
+----------------------------------------------- +
| STRICTALLTABLES |
+----------------------------------------------- +
Para cambiar este parámetro, a uno adecuado al framework, debe ejecutar el siguiente comando: mysql> set [global | session] sqlmode = ; o cambiar la configuración del archivo my.ini en su sistema operativo. Para ver otros parámetros ver el siguiente enlace [1]

5.2. Oracle

Kumbia trabaja con la extensión de PHP OCI8. Estas funciones le permiten acceder a bases de datos Oracle 10, Oracle 9, Oracle 8 y Oracle 7 usando la Interfaz de Llamados Oracle (OCI por sus siglas en Inglés). Ellas soportan la vinculación de variables PHP a recipientes Oracle, tienen soporte completo LOB, FILE y ROWID, y le permiten usar variables de definición entregadas por el usuario. Advertencia: En Oracle la funcionalidad limit podría no funcionar como se espera. Utilice la condición rownum < numerofilas para hacer esto.

5.3. Postgresql

6. Instalación de paquetes integrados (apache, php, mysql )

6.1. Instalando Kumbia en XAMPP en Windows

El procedimiento para instalar XAMPP en Windows es el siguiente:
  1. Descargar XAMPP de Apache Friends
  2. Instalar XAMPP
  3. Habitilitar Instalar Apache y MySQL como Servicio
  4. Editar el archivo c:\Archivos de Programa\xampp\apache\conf\httpd.conf
  5. Descomentar (quitar el #) de la línea donde dice:
    LoadModule rewritemodule modules/modrewrite.so
  6. Reiniciar el servicio de Apache desde el Panel de Control de XAMPP
  7. Copiar el paquete de Kumbia a:
    c:\Archivos de Programa\xampp\apache\htdocs</li>
  8. Continuar Normalmente

6.2. Instalando Kumbia en XAMPP en GNU/Linux

El procedimiento para instalar XAMPP en cualquier distribución GNU/Linux es el siguiente: 1. Descargar XAMPP de Apache Friends 2. Instalar XAMPP 3. Copiar el paquete de Kumbia a /opt/lampp/htdocs/ 4. Continuar la instalación normalmente

6.3. Instalando Kumbia en Debian/Ubuntu Linux

Instala Apache2+MySQL5+PHP5 si no lo tienes instalado usando la guia en este blog o en Ubuntu-es. En Debian/Ubuntu tienes que usar el comando para habilitar mod_rewrite en Apache: #a2enmod rewrite y luego en editas el archivo: /etc/apache2/sites-enabled/000-default Buscas la línea para el directorio /var/www donde dice: AllowOverride None y cambiar por AllowOverride All Reinicias Apache con: # /etc/init.d/apache2 restart Continuar normalmente

6.4. Instalando Kumbia en Apache2Triad


Comments