Version 8, last updated by Deivinson Tejeda at Sep 12 21:15 2008 UTC

Decrease font size Decrease font size

Increase font size Increase font size

Print this page Print this page

nuestra-primera-aplicacion

Introducción

En el presente capitulo tiene como objetivo crear una aplicación en Kumbia para comprender de una manera sencilla el Patrón de Diseño MVC y al mismo tiempo el funcionamiento del framework.

Capitulo 1. Nuestra primera aplicación

Una vez obtenida la copia del framework descomprimimos y renombramos la carpeta con el nombre de nuestro proyecto, para efecto del ejemplo llamaremos a nuestro proyecto kumbia, tal como se muestra en la imagen.

 

 

 

Dentro del directorio Kumbia y se hace enfasis que kumbia es nuestro proyecto este podria tener cualquier otro nombre, tendremos un arbol de directorios tal como se muestra en la siguiente imagen.

 

 

Antes de continuar vamos a verificar que todo este trabajando bien en nuestras configuraciones a nivel de servidor web, para esto abrimos nuestro navegador web y colocamos http://localhost/kumbia, si todo esta funcionando bien deberia mostrarnos la siguiente imagen.

 


 

1. Hola Kumbia.

Ahora tenemos que escribir el famosos Hola Mundo! pero nosotros hicimos un pequeño cambio y sera Hola Kumbia! SmilePensando en esto recordemos el modelo MVC. Según esto, Kumbia debería aceptar una petición que buscaría en controlador y en éste, una acción que atendería la petición, luego el controlador utilizaría una vista para mostrar la información al usuario.

Para escribir el código de nuestro Hola Kumbia!, no necesitamos sino un controlador y una ista. No necesitamos modelos ya que no estamos trabajando la información de una base de datos.

Nos ubicamos en el directorio apps/default/controllers aqui estaran nuestros controladores, para crear un controlador es importante tener en cuenta las convenciones de nombre que utiliza el Framework, para entender mejor nosotros llamaremos a nuestro controlador saludo_controller.php notese el sufijo _controller.php esto forma parte de la convencion de nombre y esto hace que Kumbia identifique ese archivo como un controlador.

Dentro de este archivo colocaremos las siguientes lineas de codigo.

saludos_controller.php

  1. <?php
  2. class SaludoController extends ApplicationController {
  3.     public function index() {}
  4. }
  5. ?>

como vemos en una clase con un metodo index, notese que tambien esta el sufijo Controller al final de la declaracion de la clase esto la identifica como una clase controladora y esta hereda (extends) de la superclase ApplicationController con lo que adquiere las propiedades de una clase controladora.

2. Kumbia URLS.

Para continuar de una manera que vayamos entendiendo el funcionamiento del framework es importante entender sus URL, hagamos una desconponsicion de esta URL http://localhost/kumbia/saludo/index.

http://localhost => Dominio

/kumbia => Nombre del Proyecto

 /saludo => Nombre del Controlador

/index => Nombre de una Action del controller

Cualquier otra informacion pasada por URL es tomada como parametro para proposito de nuestra aplicación.

3. Kumbia en Acción.

Retomando la parte 1 de este apartado, vamos a ejecutar desde el navegador nuestro controlador saludo y la acción index de la siguiente manera http://localhost/kumbia/saludo/index nos muestra lo siguiente.

 


 

Como podemos darnos cuenta tenemos una acción vacia sin nada que mostrar al usuario que realizo la solicitud, esto es sencillo de deducir ya que no tenemos ninguna vista asociada a nuestra acción.

Agreguemosle contenido a la acción index, esto lo hacemos creando un directorio con el mismo nombre de nuestro controlador en este caso deberia llamarse saludo y dentro de este estaran todas las vistas asociadas a las acciones que necesiten mostrar alguna información.

Para efecto del ejemplo llamamos a una acción llamada index por lo tanto creamos un archivo llamado index.phtml fijese que el archivo se llama igual que la acción, este archivo lo creamos en el directorio

 

apps/default/views/saludo/index.phtml

 

Una vez creado este archivo le agregamos un poco de contenido...

index.phtml

  1. <h1>Hola Kumbia</h1>

Ahora si volvemos ejecutar desde nuestro navegador web http://localhost/kumbia/saludo/index si nos debe mostrar el contenido del archivo index.phtml, tal como se muestra en la imagen.

 

 

Pues como se ve ya hemos ejecutado la primera accion en Kumbia esto nos permite apreciar el comportamiento del framework.

4. Agregando mas Contenido.

Ahora vamos a mostrar la hora y fecha haciendo uso de la funcion date(), con esto evitamos tener un contenido estático y tener un sitio mas dinámico, editamos el archivo saludo_controller.php.

saludos_controller.php

  1. <?php
  2. public class SaludoController extends ApplicationController {
  3.     public function index() {
  4.         $this->fecha = date("Y-m-d H:i");
  5.     }
  6. }
  7. ?>

Y la vista index.phtml quedaria asi:

index.phtml

  1. <h1>Hola Kumbia</h1>
  2. <? echo $fecha ?>

Nota

Cuando hacemos uso $this sobre una variable en el controlador, como se puede apreciar con $this->fecha automaticamente tenemos esa variable en la vista de la siguiente manera $fecha, esto porque kumbia trabaja con variable de instancia.

Ahora si volvemos a ejecutar http://localhost/kumbia/saludo/index obtendremos la hora y fecha del momento que se haga la petición tal como se muestra en la imagen.

 

 

5. Repitiendo la Historia.

Ahora vamos a crear otro controlador que lo llamaremos despedida haciendo memoria tendremos un archivo en apps/default/controllers/despedida_controller.php

despedida_controller.php

  1. <?php
  2. public class DespedidaController extends ApplicationController {
  3.     public function adios() {
  4.        
  5.     }
  6. }
  7. ?>

Tal como se menciona arriba creamos una vista con el nombre de la acción en este caso nuestra vista en apps/default/views/despedida/adios.phtml

adios.phtml

  1. <h1>Adios</h1>
  2. <? echo link_to("saludo/index", "Volver a Saludar") ?>

Ahora colocamos en nuestro navegador http://localhost/kumbia/despedida/adios obtendremos un texto y un vinculo hacia nuestro controlador saludo y la acción index.

 


 

link_to, es un helpers que ofrece kumbia para facilitar al momento de programar este helpers es equivalente hacer

<a href="kumbia/saludo/index">Volver a Saludar</a> esto funciona bien, pero que sucederia si decidimos cambiar el nombre de la aplicacion de kumbia a demo por ejemplo, significa que deberias cambiar los vinculos de la aplicacion para que apunten a la nueva ubicación.