Kohana: Tutorial 1Con este artculo comienzo una serie de tutoriales de Kohana.

Kohana es un Framework PHP, es decir: un entorno de trabajo prefabricado que ya nos soluciona algunos de los problemas ms tpicos de la programacin.

Como me gusta avanzar programando, programaremos desde la primera lnea. Para ello vamos a tener como objetivo la creacin de un ToDoList Manager, es decir: vamos a crear una web que nos permita gestionar tareas.

En el ejemplo se acceder a base de datos. Debo decir que me ha costado mucho encontrar ejemplos vlidos que accedan a base de datos.

PrerrequisitosVoy a utilizar Kohana versin 3.0.8. Seguramente sea compatible con las siguientes.

Un poquito de teoraKohana sigue un patrn Modelo-Vista-Controlador (MVC). Hay mucho escrito sobre

este patrn, por lo que no me extender demasiado:

Modelo: Los datos tal cual se guardan.

Vista: La representacin en la pantalla.

Controlador: La lgica de negocio.

ConfiguracinVamos a configurar Kohana. Hemos desplegado el framework y vamos al

fichero application/bootstrap.php, en el que vamos a habilitar algunas cosas. No podis copiar a ciegas; aqu slo os doy un ejemplo de lo que tengo yo puesto. Tened tambin en cuenta que no lo pego entero, ya que nos valen la mayor parte de los valores por defecto:

Como es sencillo, voy rpido: Le decimos a Kohana dnde est nuestra aplicacin y cul es el archivo que va a renderizar las cosas. Como vis, yo lo tengo en /~miguel/kohana. Despus habilitamos algunos mdulos, que servirn para acceder a base de datos.

Si sois tan pijos como yo y os gustan las URLs limpias, mejor si indicis el index_file de la manera que se indica arriba y despus creis un.htaccess como el siguiente:

# Turn on URL rewritingRewriteEngine On

# Installation directoryRewriteBase /~miguel/kohana/

# Protect hidden files from being viewed

Order Deny,Allow Deny From All

# Protect application and system files from being viewedRewriteRule ^(?:application|modules|system)\\b.* index.php/$0 [L]

# Allow any files or directories that exist to be displayed directlyRewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-d

# Rewrite all other URLs to index.php/URLRewriteRule .* index.php/$0 [PT]

Finalmente, configuramos la base de datos en el archivomodules/database/config/database.php. Ya tenis un patrn y es autoexplicativo. Centraros en default y olvidaros de alternate (o borradlo si queris).

El modeloEl modelo es lo que existe en la base de datos, bsicamente. As que comenzamos por

crear una base de datos:

CREATE TABLE `tasks` ( 'id' int(11) NOT NULL AUTO_INCREMENT, 'title' varchar(60) NOT NULL, 'description' longtext NOT NULL, 'created' datetime NOT NULL, 'duedate' datetime DEFAULT NULL, PRIMARY KEY ('id'), UNIQUE KEY 'title' ('title')) ENGINE=MyISAM AUTO_INCREMENT=17 DEFAULT CHARSET=utf8;

Ahora tenemos que decirle a Kohana que use esta tabla. Para ello basta crear el archivo application/classes/model/task.php:

Bien. Paremos. Para qu queremos un archivo vaco?

Realmente no est vaco. Para empezar, estamos restringiendo el acceso. Todos

nuestros archivos PHP salvo las vistas deberan comenzar as, por seguridad. Adems, estamos heredando de ORM, y esta clase padre ya nos dar todo lo que necesitamos: acceder a la base de datos y ver qu campos necesitamos aqu.

Personalmente, tanto automatismo no me gusta demasiado y prefiero indicarle qu tabla es la que quiero emplear:

Y hemos terminado el modelo. Fcil, no?

El ControladorCreamos el archivo application/classes/controller/task.php:

}

private function getAsDate ($value) { $result = null; if (isset ($value)) { $result = $value." 00.00.00"; } print_r($result); return $result; }

private function get_tasklist () { $tasks = ORM::factory('task')->find_all();

$result = array();

foreach ($tasks as $task) $result[] = $task;

return $result; }

}?>

Analicemos un poco este cdigo.

Lo primero de todo es la seguridad, por lo que evitamos el acceso directo.

A continuacin se crea una clase Controller_Task que hereda deController. El nombre de la clase est sujeto a una convencin de nombres, y heredamos de Controller porque somos un controlador :D

El constructor no tiene mucho misterio: tenemos que implementarlo y llamamos al constructor padre. No tenemos nada ms que inicializar, por lo que podemos terminar.

La funcin action_index es, como el nombre indica, una accin. Ser la accin por defecto que se ejecute cuando alguien realice una solicitud sobre el controlador. Si simplificamos su cdigo hasta un simple echo hola;, podremos comprobar que todo funciona accediendo a la misma direccin que pusimos en la configuracin, en base_url, seguido del nombre bsico del controlador, es decir, task. En mi caso, la direccin eshttp://localhost:/~miguel/kohana/task. Si no habis activado las URLs limpias, tendris que indicar quin debe renderizar esa pgina, accediendo a algo como http://localhost:/~miguel/kohana/index.php/task.

Como vemos, la accin action_index crea una vista a partir de una plantilla y la devuelve como respuesta. Veremos ms sobre estas vistas en el apartado siguiente.

La accin action_add va a tratar de crear una tarea nueva. Adems, voy a reutilizar esta funcin. Si viene sin datos, slo mostrar la ventana. Si viene con datos, crear una nueva tarea. Por ello, lo primero que hago es crear la vista que voy a devolver, ya que es comn a ambos casos de uso, y despus trato de insertarla, guardndome un mensaje en cada caso.

La funcin create_task es quien realmente crea la tarea. Para ello hace uso del ORM, obteniendo los valores de la variable $_POST. Las fechas tengo que

modificarlas a mano para que tengan el formato esperado por mysql (YYYY-MM-DD hh.mm.ss).

La funcin get_tasklist serializa la lista de tareas para pasrsela a la vista.

Cosas importantesAqu hay dos cosas importantes: el uso de la base de datos y el paso de parmetros

con la vista.

Para usar la base de datos, estamos usando el ORM. ste estbastante bien documentado.

Para obtener datos de la vista, los obtenemos de la variable $_POST, ya que ste ha sido el mtodo que he decido utilizar para el envo de datos (y suele ser el ms recomendable). Los nombres de los campos son los que he puesto en la vista y que veremos ms adelante.

Para enviar datos a la vista, lo que hago es establecerlos al objeto View con la funcin set. Esto funcionar como una tabla Hash cuando est en la vista.

Las vistasAntes de entrar en materia, como no me gusta repetirme, crearemos un par de

archivos. Todas las vistas deben ir en application/views.

Los dos archivos a crear no tienen mayor misterio y no entrar a describirlos:

header.php

Vista para Kohana PHP Date.firstDayOfWeek = 1; Date.format = 'yyyy/mm/dd'; $(document).ready(function() { $(".date").datepicker({ dateFormat: 'yy-mm-dd', firstDay: 1 }); });

footer.php

S, hago algo de uso de jquery, pero no os asustis que slo es para la insercin de fechas. El resto de la aplicacin ser horrible :-P

Vamos con el ndice:

task_index.php

Title Creation Due date Planned date Completed

Como en la funcin del controlador action_index insertamos la variable $task_list,

ahora podemos recuperarla y recorrerla. De esta manera creamos una vista horrible. Dejo como tarea ponerla bonita, ya que eso no es el tema de este tutorial.

Nos queda poder aadir tareas (task_add.php):

print form::label('duedate', 'Due Date:');print form::input('duedate', null, array ('class'=>'date') );print form::submit('submit', 'Send');print form::close();?>

En este caso he creado un formulario utilizando las funciones de Kohana. Como vis,

los nombres de los campos se corresponden con los que utilic en la funcin create_task.

FinComo decan en en 1,2,3 hasta aqu puedo leer. Como primera aplicacin me

parece mucho ms interesante que el triste hola mundo, ya que tiene todos los componentes de una aplicacin real: modelo, vista y controlador (el hola mundo no tiene ms que controlador), acceso a bases de datos, etc.

No he entrado con el update_task ya que no es ms complicado que el create_task. Lo dejo como ejercicio.

Habr segunda parte de este tutorial.

ReferenciasNo hay mucha documentacin de Kohana. Sin embargo, el ORM de Kohana s est

bien documentado y no creo que tengis mayor problema con esa parte. Siempre prefiero utilizar sistemas que me eviten el SQL a mano, ya que ste puede tener sql-injection.

Acordos de seguir las convenciones. Tambin podis echar un vistazo a otros tutoriales, como el de Ajaxman o el de Christian Gil, sin contar los tutoriales de la propia pgina de Kohana.

Espero que os haya resultado interesante.

PrerrequisitosUn poquito de teoraConfiguracinEl modeloEl ControladorCosas importantes

Las vistasheader.phpfooter.phptask_index.php

FinReferencias