Instalar Kumbia
Requisitos
Servidor web Apache en cualquier versión bajo Windows 2000/XP/Vista ó Linux/UNIX.
Puedes utilizar IIS con Isapi_Rewrite instalado.
También se puede utilizar Cherokee Web server
Instalar PHP5+ (recomendado 5.2) Motor de base de datos soportado si se necesitase.
Descargar Kumbia
Kumbia se distribuye en un paquete comprimido listo para usar. Se puede descargar la última versión de:
http://www.kumbiaphp.com/ http://sourceforge.net/projects/kumbia/
El nombre del paquete tiene un nombre como kumbia-version-notes.formato, por ejemplo: kumbia-0.4.7a-stable.tar.gz
Configurando apache
KumbiaPHP Framework utiliza un módulo llamado mod_rewrite para la reescritura de URLs y hacerlas más comprensibles 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 (de acuerdo a la versión de apache)
<Directory "/to/document/root"> Options Indexes FollowSymLinks AllowOverride All Order allow,deny Allow from all </Directory>
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 mod_rewrite.
Habilitando Mod_Rewrite en S.O. Basados en GNU/Linux (Debian, Ubuntu y derivadas)
#a2enmod rewrite #/etc/init.d/apache restart
Habilitando Mod-Rewrite es Fedora
#vi /etc/httpd/conf/httpd.conf
Buscar la línea...
#LoadModule rewrite_module modules/mod_rewrite.so
El "#" al principio indica que la línea esta comentada, lo que quiere decir que apache no cargara el modulo si fuese este el caso quitar el "#".
En el mismo archivo buscar...
<Directory /> Options FollowSymLinks AllowOverride None </Directory>
Donde dice None reemplazarlo por All, para que apache interprete los archivos .htaccess.
Reiniciar el servicio httpd (apache)
# service httpd restart
¿Por qué es importante 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. KumbiaPHP Framework 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, KumbiaPHP 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.
NOTA: Se trabaja actualmente para que este requisito no sea indispensable.
¿Porque KumbiaPHP utiliza PHP5?
KumbiaPHP trabaja sólo con PHP5 ya que es la versión más avanzada, estable y es el futuro de este lenguaje. Posee un soporte más completo a la orientación a objetos. Esta características de PHP5 proporcionan un toque profesional a las aplicaciones desarrolladas esto con la intención que se abandone el uso de PHP4.
Configurando 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.
Para que OCI8 trabaje es necesario instalar el cliente instantáneo de oracle. Luego hay que agregar a la variable de entorno PATH del sistema la ruta a donde fue descomprimido el cliente instantáneo.
PATH=%PATH%; c:\instantclient10_2\
Reiniciar Apache
Advertencia: En Oracle la funcionalidad limit podría no funcionar como se espera. Utilice la condición rownum < numero_filas para hacer esto.
Configurar XAMPP
Instalando XAMPP bajo Windows
El procedimiento para instalar XAMPP en Windows es el siguiente:
- Descargar XAMPP de Apache Friends
- Instalar XAMPP
- Habitilitar Instalar Apache y MySQL como Servicio
- Editar el archivo c:\Archivos de Programa\xampp\apache\conf\httpd.conf
- Descomentar (quitar el #) de la línea donde dice:
- LoadModule rewrite_module modules/mod_rewrite.so
- Reiniciar el servicio de Apache desde el Panel de Control de XAMPP
- Copiar el paquete de Kumbia a:
- c:\Archivos de Programa\xampp\apache\htdocs\
- Continuar Normalmente
Instalando XAMPP bajo GNU/Linux
El procedimiento para instalar XAMPP en cualquier distribución GNU/Linux es el siguiente:
- Descargar XAMPP de Apache Friends
- Instalar XAMPP
- Copiar el paquete de Kumbia a /opt/lampp/htdocs/
- Continuar la instalación normalmente
Instalando XAMPP bajo 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
Verificar la instalación de Kumbia
La verificación del buen funcionamiento de Kumbia y la instalación realizada es muy simple. Debéis abrir el navegador web ( explorer, firefox, opera ) y escribir:
http://localhost/<directorio_paquete_kumbia>/
<directorio_paquete_kumbia> lo debéis substituir por la carpeta donde habéis descomprimido el paquete.
Si todo esta correcto os mostrará una pantalla de bienvenida, en caso contrario os informará sobre error o errores detectados.