Revisión actual |
Tu texto |
Línea 1: |
Línea 1: |
| = Requisitos = | | = Requisitos = |
− | *Servidor web capaz de ejecutar PHP: '''Apache''' en cualquier versión bajo Windows 2000/XP/Vista/7 ó Linux/UNIX, '''IIS''' con Isapi_Rewrite instalado, '''Cherokee Web server''', '''Lighttpd''' (soporte experimental), o cualquier web server con soporte de PHP y módulo de reescritura URL (mod_rewrite o su equivalente).En caso de usar un servidor no nombrado aquí debe realizar la adaptación.
| + | Servidor web Apache en cualquier versión bajo Windows 2000/XP/Vista ó Linux/UNIX. |
− | *PHP 5.2.x (Se debe seleccionar una versión que posea PHP 5.2.x, KumbiaPHP no tolera los bugs de PHP 5.3.x) instalando y funcionando en el servidor
| |
− | *Motor de base de datos soportado si se necesitase. (Ejemplo: MySQL Server, Oracle, Firebird...)
| |
| | | |
− | = Descargar KumbiaPHP Framework =
| + | Puedes utilizar IIS con Isapi_Rewrite instalado. |
| | | |
− | KumbiaPHP se distribuye en un paquete comprimido listo para usar. Se puede descargar la última versión de:
| + | También se puede utilizar Cherokee Web server |
| + | |
| + | Instalar PHP5+ (recomendado 5.2) |
| + | Motor de base de datos soportado si se necesitase. |
| + | |
| + | Actualmente se está desarrollando el soporte para '''lighttpd''' |
| + | |
| + | = 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://www.kumbiaphp.com/ |
| + | http://sourceforge.net/projects/kumbia/ |
| | | |
− | El nombre del paquete tiene un nombre como kumbia-version-notes.extensión, por ejemplo: kumbia-0.4.7a-stable.tar.gz | + | El nombre del paquete tiene un nombre como kumbia-version-notes.formato, por ejemplo: kumbia-0.4.7a-stable.tar.gz |
| | | |
| == Configurando apache == | | == Configurando apache == |
Línea 29: |
Línea 37: |
| === Habilitando Mod_Rewrite en S.O. Basados en GNU/Linux (Debian, Ubuntu y derivadas) === | | === Habilitando Mod_Rewrite en S.O. Basados en GNU/Linux (Debian, Ubuntu y derivadas) === |
| | | |
− |
| |
− | Nos aseguramos primero de activar el mod_rewrite de esta manera y como usuario root
| |
| <pre> | | <pre> |
| #a2enmod rewrite | | #a2enmod rewrite |
− | | + | #/etc/init.d/apache restart |
− | Para windows hay que activar el mododulo
| |
− | | |
− | LoadModule rewrite_module modules/mod_rewrite.so
| |
− | | |
− | en el archivo httpd.conf
| |
− | | |
− | Es decir
| |
− | Sustituir esta linea de codigo
| |
− | #LoadModule rewrite_module modules/mod_rewrite.so
| |
− | por esta
| |
− | LoadModule rewrite_module modules/mod_rewrite.so
| |
− | | |
− |
| |
− | | |
− | </pre>
| |
− | Despues de este paso editamos el siguiente archivo:
| |
− | <pre>
| |
− | $ sudo vi /etc/apache2/sites-enabled/000-default
| |
− | </pre>
| |
− | Recuerde que puede escoger cualquier editor: vi, nano, gedit, etc en este ejemplo usamos vi. Cuando estemos dentro de dicho archivo, vamos a cambiar las siguientes líneas que aparezcan así:
| |
− | ''AllowOverride None'' por esta otra: ''AllowOverride All''
| |
− | | |
− | En el caso de la distribución Ubuntu y Xubuntu, existen 4 líneas de estas dentro del archivo 000-default.
| |
− | | |
− | | |
− | Ahora solo reiniciamos nuestro servicio Apache
| |
− | <pre>
| |
− | #/etc/init.d/apache2 restart | |
− | </pre>
| |
− | | |
− | === Instalando KumbiaPHP en centOS5 y RHEL5 ===
| |
− | | |
− | El método para centOS5 es exactamente igual al de RHEL5, sin embargo '''no recomendamos hacer las modificaciones que acá se sugieren a un RHEL5''' a menos que sea estrictamente necesario y tiene que tomar en cuenta que su licencia de soporte RHEL no cubre aplicaciones sobre paquetes que no son oficiales de RHEL.
| |
− | | |
− | Primero que todo, la versión de php que trae centOS5 y RHEL5 es la 5.1.X, así que kumbiaphp puede instalarse, sin embargo funciona mal, es posible que en los logs de errores de su apache vea algo parecido a:
| |
− | | |
− | <pre>
| |
− | PHP Fatal error: Call to undefined method XMLWriter
| |
− | </pre>
| |
− | | |
− | Y que algunas vistas no se carguen adecuadamente, eso es debido a que la versión de php-xml que trae php 5.1.X no es muy compatible con los requerimientos de kumbiaphp, para que kumbiaphp trabaje adecuadamente debe estar sobre php 5.2.x, por lo tanto para instalar php 5.2.x de forma sencilla agregue el repositorio de http://www.atomicorp.com, como root:
| |
− | | |
− | <pre>
| |
− | wget http://www.atomicorp.com/channels/atomic/centos/5/i386/RPMS/atomic-release-1.0-10.el5.art.noarch.rpm
| |
− | rpm -ivh atomic-release-1.0-10.el5.art.noarch.rpm
| |
− | yum clean all
| |
− | yum install php
| |
− | </pre>
| |
− | | |
− | Esto podrá actualizar todos los paquetes de php a una versión adecuada para kumbiaphp, debe tomar en cuenta que '''debe tener mucho cuidado debido a que si realiza este procedimiento en un hosting compartido con otras aplicaciones, posiblemente algunas de ellas dejen de funciona adecuadamente''', sobre todo si tiene versiones muy viejas de CMS, si esto sucede y quiere regresar todo a como estaba puede hacer rollback de la siguiente manera:
| |
− | | |
− | <pre>
| |
− | rpm -e atomic-release
| |
− | yum clean all
| |
− | rpm -qa | grep php
| |
− | yum remove php*
| |
− | yum install php
| |
− | </pre>
| |
− | | |
− | Si le hace falta alguna librería de php, simplemente instalela vía yum y luego siga las instrucciones para habilitar Mod-Rewrite en Fedora.
| |
− | | |
− | Si le da problemas la conexión a base datos revise /var/log/messages y verifique si SELINUX está lanzando mensajes similares a:
| |
− | | |
− | <pre>
| |
− | setroubleshoot: SELinux está negando al demonio http que se conecte a una base de datos. For complete SELinux messages. run sealert -l 3d5d
| |
− | </pre>
| |
− | | |
− | si es así, puede desactivar SELINUX hasta que consiga la regla de contexto que permita al webserver acceder a base de datos:
| |
− | | |
− | <pre>
| |
− | setenforce 0
| |
| </pre> | | </pre> |
− |
| |
− | O de plano desactive SELINUX de forma definitiva editando el archivo /etc/selinux/config.
| |
| | | |
| === Habilitando Mod-Rewrite en Fedora === | | === Habilitando Mod-Rewrite en Fedora === |
Línea 149: |
Línea 82: |
| | | |
| '''NOTA:''' Se trabaja actualmente para que este requisito no sea indispensable. | | '''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 == | | == Configurando Oracle == |
Línea 170: |
Línea 107: |
| El procedimiento para instalar XAMPP en Windows es el siguiente: | | El procedimiento para instalar XAMPP en Windows es el siguiente: |
| | | |
− | #Descargar XAMPP de Apache Friends. Se debe seleccionar una versión que posea PHP 5.2.x, KumbiaPHP no tolera los bugs de PHP 5.3.x. | + | #Descargar XAMPP de Apache Friends |
| #Instalar XAMPP | | #Instalar XAMPP |
| #Habitilitar Instalar Apache y MySQL como Servicio | | #Habitilitar Instalar Apache y MySQL como Servicio |
Línea 179: |
Línea 116: |
| #Copiar el paquete de Kumbia a: | | #Copiar el paquete de Kumbia a: |
| ##c:\Archivos de Programa\xampp\apache\htdocs\ | | ##c:\Archivos de Programa\xampp\apache\htdocs\ |
− | #Continuar Normalmente | + | #Continuar Normalmente |
| | | |
| == Instalando XAMPP bajo GNU/Linux == | | == Instalando XAMPP bajo GNU/Linux == |
Línea 185: |
Línea 122: |
| El procedimiento para instalar XAMPP en cualquier distribución GNU/Linux es el siguiente: | | El procedimiento para instalar XAMPP en cualquier distribución GNU/Linux es el siguiente: |
| | | |
− | #Descargar XAMPP de Apache Friends. Se debe seleccionar una versión que posea PHP 5.2.x, KumbiaPHP no tolera los bugs de PHP 5.3.x. | + | #Descargar XAMPP de Apache Friends |
| #Instalar XAMPP | | #Instalar XAMPP |
| #Copiar el paquete de Kumbia a /opt/lampp/htdocs/ | | #Copiar el paquete de Kumbia a /opt/lampp/htdocs/ |
Línea 200: |
Línea 137: |
| | | |
| Buscas la línea para el directorio /var/www donde dice: AllowOverride None y cambiar por AllowOverride All | | Buscas la línea para el directorio /var/www donde dice: AllowOverride None y cambiar por AllowOverride All |
− |
| |
− | Posterior a esto hay que indicar al servidor web cual será el orden de preferencias en
| |
− | cuanto a los archivos index, por defecto en primer orden se ejecutan los archivos
| |
− | index.html esto hay que cambiarlo por index.php.
| |
− | En version 2.2.x de apache solo hay que editar el archivo que se encuentra en:
| |
− |
| |
− | /etc/apache2/mods-enabled/dir.conf
| |
− |
| |
− | 1. DirectoryIndex index.php index.html ...
| |
| | | |
| Reinicias Apache con: | | Reinicias Apache con: |
Línea 226: |
Línea 154: |
| Si todo esta correcto os mostrará una pantalla de bienvenida, en caso contrario os informará sobre error o errores detectados. | | Si todo esta correcto os mostrará una pantalla de bienvenida, en caso contrario os informará sobre error o errores detectados. |
| | | |
− | = Configurando Lighttpd = | + | == Configurando Lighttpd == |
− | {{Experimental}}
| + | ''' Atención esta Sección está siendo testeada actualmente, así que podría cambiar en cualquier momento, no es recomendable usarla en entornos de producción hasta que se haya terminado de probar''' |
− | | |
− | Lo primero que debemos hacer es activar el módulo mod_rewrite, lo que nos permitirá el usa de ''URL amigables'', buscamos en el archivo de configuración del lighttpd la siguiente directiva, '''server.modules''', y verás algo como esto:
| |
− | | |
− | server.modules = (
| |
− | "mod_access",
| |
− | "mod_alias",
| |
− | "mod_accesslog",
| |
− | "mod_compress",
| |
− | "mod_fastcgi",
| |
− | # "mod_rewrite",
| |
− | # "mod_redirect",
| |
− | # "mod_evhost",
| |
− | # "mod_usertrack",
| |
− | # "mod_rrdtool",
| |
− | # "mod_webdav",
| |
− | "mod_expire"
| |
− | # "mod_flv_streaming",
| |
− | # "mod_evasive"
| |
− | )
| |
− | Debemos remover la almohadilla (#) delante del '''mod_rewrite''', y que quede algo como:
| |
− | server.modules = (
| |
− | "mod_access",
| |
− | "mod_alias",
| |
− | "mod_accesslog",
| |
− | "mod_compress",
| |
− | "mod_fastcgi",
| |
− | "mod_rewrite",
| |
− | # "mod_redirect",
| |
− | # "mod_evhost",
| |
− | # "mod_usertrack",
| |
− | # "mod_rrdtool",
| |
− | # "mod_webdav",
| |
− | "mod_expire"
| |
− | # "mod_flv_streaming",
| |
− | # "mod_evasive"
| |
− | )
| |
− | Si no había ningún # antes del '''mod_rewrite''' omite el paso anterior. Luego de eso agrega al final del archivo algo como esto:
| |
− | | |
− | url.rewrite += ( "^/kumbiaphp/$" => "/kumbiaphp/app/public/" )
| |
− | url.rewrite += ( "^/kumbiaphp/([^\.]*)$" => "/kumbiaphp/app/public/index.php?url=/$1" )
| |
− | url.rewrite += ( "^/kumbiaphp/(.+)$" => "/kumbiaphp/app/public/$1" )
| |
− | | |
− | Debes sustituir '''"kumbiaphp"''' (sin las comillas) por el nombre del directorio donde esta KumbiaPHP. Luego de esto reinicia el servidor y prueba.
| |