Instalación básica de Kohana 3

Introducción.

Kohana es un framework de PHP que siempre me ha parecido interesante por su simplicidad y claridad.  Inicialmente se originó como un fork de Codeigniter y posteriormente fue refinándose y alejándose un poco de este.  En lo personal me gusta mas Kohana que CI porque a pesar de ser mas jóven, me parece que han logrado consolidar mejor los recursos y la comunidad de este framework haciendo que se sienta mas sólido y mas robusto, especialmente me parece superior en su mejor orientación a objetos, soporte a PHP5 (la premisa de CI es soportar PHP4 también) y algunos módulos de core (CI tiene versiones análogas como adendos).

Tuve la oportunidad de desarrollar un proyecto con la versión 2.2 con muy buenos resultados.  A mediados del mes pasado se realizó la primera liberación estable de Kohana 3.0 que es la consolidación de la experiencia obtenida durante la serie 2.x y se constituye como una reescritura desde cero del framework.

Aún no estoy del todo seguro si me es conveniente utilizar en este momento esta nueva versión y si por el contrario permanezco con la 2.3.4 y la 2.4 próximamente.  La nueva versión difiere bastante de la existente por lo cual su API no tiene compatibilidad hacía atrás haciendo que los cambios para la actualización sean extensos y probablemente inviables.

De cualquier manera hoy me picó el gusanito de la curiosidad y ya que la documentación no será basada en un Wiki como estabamos acostumbrados sino que se generará de la documentación inline del mismo framework, acabo de instalarlo y de activar el módulo respectivo para consultarla.

La idea es instalar el framework (system/ y modules/) en un directorio por fuera del árbol público (/home/www/kohana/3.0_dev) y sólo instalar en él lo realmente relacionado con la aplicación (/home/www/public/kohana/application).

Procedimiento.

La versión convencional de este procedimiento inicia descargando la versión .ZIP de la distribución desde el repositorio del proyecto, sin embargo como mi interés primordial es el de consultar la documentación, prefiero descargar la versión mas fresca posible y esto se realiza a través del GIT del proyecto.

Descargar la distribución mas reciente de Kohana 3.

$ cd /home/www/public

$ git clone git://github.com/kohana/kohana.git

$ cd kohana

$ git submodule init

$ git submodule update

Ubicación del framework en el directorio no público.

$ mkdir -p /home/www/kohana/3.0_dev

$ mv system/ modules/ /home/www/kohana/3.0_dev

Establecer los permisos requeridos para la aplicación.

$ chmod 777 application/logs/

$ chmod 777 application/cache/

Realizar la configuración general.

$ vi index.php

$application = ‘application’;
$modules     = ‘/home/www/kohana/3.0_dev/modules’;
$system      = ‘/home/www/kohana/3.0_dev/system’;

Realizar la revisión general de requisitos.

Consultar el URL correspondiente a  http://localhost/kohana/index.php.  Si los requisitos se cumplen proceda con el siguiente paso, de lo contrario soluciónelos y vuelva a ejecutar la revisión.

$ rm install.php

Realizar la configuración general (segunda parte).

$ vi application/bootstrap.php

// Establecer la zona horaria por defecto, mas información en http://php.net/timezones.
date_default_timezone_set('America/Bogota');

// Establecer el URL base de la aplicación, por defecto es kohana donde se recupera el GIT.
Kohana::init(array('base_url' => '/kohana/'));

// Activar los módulos necesarios.  userguide es la documentación.
Kohana::modules(array(
 // 'auth'       => MODPATH.'auth',       // Basic authentication
 // 'codebench'  => MODPATH.'codebench',  // Benchmarking tool
 // 'database'   => MODPATH.'database',   // Database access
 // 'image'      => MODPATH.'image',      // Image manipulation
 // 'orm'        => MODPATH.'orm',        // Object Relationship Mapping
 // 'pagination' => MODPATH.'pagination', // Paging of results
    'userguide'  => MODPATH.'userguide',  // User guide and API documentation
 ));

// Establece el estilo de ruta y el controlador/acción por defecto.
Route::set('default', '(<controller>(/<action>(/<id>)))')
  ->defaults(array(
              'controller' => 'main',
              'action'     => 'index',
   ));

Consultar la documentación del framework.

Acceder a la URL correspondiente a la siguiente de acuerdo a las rutas exactas de instalación.

http://localhost/kohana/index.php/guide

Enlaces.

Leave a Reply

Your email address will not be published. Required fields are marked *