Edición de «Hola Mundo KumbiaPHP Framework»

El presente ejemplo tiene como objetivo entender la creación de una primera aplicación usando [http://www.kumbiaphp.com KumbiaPHP], que nos servirá para entender la arquitectura MVC y algunos características interesantes. 

= Creando una nueva aplicación =

Lo primero que se debe hacer es [http://sourceforge.net/projects/kumbia/files/Kumbia/KumbiaPHP%201.0/kumbiaphp_1.0b1.zip/download Descargar la Versión 1.0] de KumbiaPHP, Una vez obtenida la copia del Framework descomprimimos y cambiamos el nombre la carpeta con el nombre de nuestro proyecto, para efecto del ejemplo llamaremos a nuestro proyecto '''kumbiaphp''' quedando de la siguiente forma:

<pre>
kumbiaphp/
|-- app
|-- core
</pre>

Mas detalles sobre la [[KumbiaPHP_Framework_Versión_1.0_Spirit#Nueva_Estructura_de_Directorios | Estructura de Directorio]] de la [[KumbiaPHP_Framework_Versión_1.0_Spirit | Versión 1.0]].
 
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/kumbiaphp/, si todo esta funcionando bien debería mostrarnos la [http://www.kumbiaphp.com/blog/2009/05/31/spirit_estrena_nueva_bienvenida/ Pantalla de Bienvenida de KumbiaPHP]. 

= Hola KumbiaPHP =

Ahora tenemos que escribir el famoso Hola Mundo! pero nosotros hicimos un pequeño cambio y sera ''Hola KumbiaPHP!'' Pensando en esto recordemos el modelo MVC. Según esto, KumbiaPHP debería aceptar una petición que buscaría en controlador y en éste, una acción que atendería la petición, luego KumbiaPHP utilizara esta información de controlador y acción para buscar la vista asociada a la petición.

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

Nos ubicamos en el directorio app/controllers/ aquí estarán nuestros controladores ([[KumbiaPHP_Framework_Versión_1.0_Spirit#Explicando_dir_app |ver mas]]), para crear un controlador es importante tener en cuenta las [[Preguntas_Frecuentes#.C2.BFCu.C3.A1l_es_la_convenci.C3.B3n_para_nombrar_los_archivos_y_clases_de_modelos_y_controladores.3F | convenciones de nombre]] que utiliza el Framework, para entender mejor nosotros llamaremos a nuestro controlador '''saludo_controller.php''' nótese el sufijo '''_controller.php''' esto forma parte de la convención de nombre y hace que KumbiaPHP identifique ese archivo como un controlador.

'''''app/controllers/saludo_controller.php'''''

Dentro de este archivo colocaremos las siguientes lineas de código.

'''saludos_controller.php'''
<source lang="php" line>
<?php 
class SaludoController extends ApplicationController {
    public function hola() 
    {
        $this->render(null);
    }
}
</source>

como vemos en una clase con un método hola(), nótese que también esta el sufijo '''Controller''' al final de la declaración 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.

=KumbiaPHP URLS= 
Para continuar de una manera que vayamos entendiendo el funcionamiento del framework es importante entender sus URL, hagamos una descomposición de esta URL http://localhost/kumbia/saludo/hola/


 http://localhost => Dominio
        /kumbiaphp => Nombre del Proyecto
             /saludo => Nombre del Controlador
                /hola => Nombre de una Accion del Controlador

Cualquier otra información pasada por URL es tomada como parámetro para propósito de nuestra aplicación.

=Nuestra Primera Acción=
Vamos a ejecutar desde el navegador nuestro controlador saludo y la acción index de la siguiente manera http://localhost/kumbia/saludo/hola/.

Como podemos darnos cuenta tenemos una acción vacía 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 '''hola'''.

<source lang="php" line>
<?php
class SaludoController extends ApplicationController {         

    public function hola() 
    {
        //quitamos el render
    }
}

</source>

Para poder ver la salida que envia el controlador es necesario crear la vista asociada a la acción, esto lo hacemos creando un directorio con el mismo nombre de nuestro controlador en este caso debería llamarse '''saludo''' y dentro de este estarán todas las vistas asociadas a las acciones que necesiten mostrar alguna información, para efecto del ejemplo llamamos a una acción llamada '''hola''' por lo tanto creamos un archivo llamado '''hola.phtml''' fíjese que el archivo se llama igual que la acción, este archivo lo creamos en el directorio:

'''app/views/saludo/hola.phtml'''

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

<source lang="php" line>
<h1>Hola KumbiaPHP</h1> 
</source>

Ahora si volvemos ejecutar desde nuestro navegador web http://localhost/kumbia/saludo/hola/ si nos debe mostrar el contenido del archivo '''hola.phtml'''

Ahora si visualizamos en el explorador se entiende que KumbiaPHP automáticamente carga la vista con el mismo nombre la acción en el directorio con el nombre del controlador seleccionado. 
Poniendo a consideración podríamos decir que las vistas permiten la salida al usuario usando PHP embebido en HTML. Por esto las vistas poseen extensión phtml a diferencia de los controladores que poseen PHP puro y por esto su extensión .php

Pues como se ve ya hemos ejecutado la primera acción en Kumbia esto nos permite apreciar el comportamiento del Framework.

=Agregando más Contenido=

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

<source lang="php" line>
<?php 
   public class SaludoController extends ApplicationController {
      public function hola() {
         $this->fecha = date("Y-m-d H:i");
      }
   }
</source>

Y la vista hola.phtml quedaría asi:

'''app/views/saludo/hola.phtml'''

<source lang="php" line>
<h1>Hola Kumbia</h1> 
<?php echo $fecha ?> 
</source>

'''Nota:''' Cuando hacemos uso de '''$this''' sobre una variable en el controlador, como se puede apreciar con $this->fecha, automáticamente tenemos esa variable en la vista de la siguiente manera $fecha, esto porque KumbiaPHP trabaja con variables de instancia.

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

=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'''

<source lang="php" line>
<?php 
public class DespedidaController extends ApplicationController {
      public function adios() {
      }
   }
}
?> 
</source>

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'''

<source lang="php" line>
<h1>Adiós</h1>
<? echo link_to("saludo/index", "Volver a Saludar") ?>
</source>

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 helper que ofrece kumbia para facilitar al momento de programar, este helper es equivalente a hacer
<source lang="html4strict" line>
<a href="kumbia/saludo/index">Volver a Saludar</a>
</source>
esto funciona bien, pero que sucedería si decidimos cambiar el nombre de la aplicación de kumbia a demo por ejemplo, significa que deberías cambiar los vínculos de la aplicación para que apunten a la nueva ubicación.