Edición de «Hola Mundo KumbiaPHP Framework»
De KumbiaPHP Framework Wiki
Advertencia: no has iniciado sesión. Tu dirección IP se hará pública si haces cualquier edición. Si inicias sesión o creas una cuenta, tus ediciones se atribuirán a tu nombre de usuario, además de otros beneficios.
Puedes deshacer la edición. Antes de deshacer la edición, comprueba la siguiente comparación para verificar que realmente es lo que quieres hacer, y entonces guarda los cambios para así efectuar la reversión.
Revisión actual | Tu texto | ||
Línea 1: | Línea 1: | ||
− | + | 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 | + | 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]. |
− | |||
− | |||
[[Archivo:Bienvenida_kumbiaphp_framework_1.0.png|800px|thumb|center|Pantala de Bienvenida de KumbiaPHP Framework]] | [[Archivo:Bienvenida_kumbiaphp_framework_1.0.png|800px|thumb|center|Pantala de Bienvenida de KumbiaPHP Framework]] | ||
− | = Hola | + | = Hola KumbiaPHP = |
− | Ahora | + | 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 | + | 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 | + | 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. | Dentro de este archivo colocaremos las siguientes lineas de código. | ||
Línea 39: | Línea 31: | ||
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
− | class SaludoController extends | + | class SaludoController extends ApplicationController { |
− | |||
public function hola() | public function hola() | ||
{ | { | ||
− | //Ver método | + | //Ver método render[1] |
− | + | $this->render(null); | |
} | } | ||
} | } | ||
</source> | </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. | |
+ | |||
+ | [1] [[KumbiaPHP_Framework_Versión_1.0_Spirit#Utilizando_el_m.C3.A9todo_render.28.24view.2C_.5B.24template.5D.29 | Método render]] | ||
− | + | 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. | |
[[Archivo:Saludo_controller_action_hola.png|1000px|thumb|center|Renderizando un Controller sin View]] | [[Archivo:Saludo_controller_action_hola.png|1000px|thumb|center|Renderizando un Controller sin View]] | ||
− | + | =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/ | |
− | =KumbiaPHP | ||
− | Para | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | 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= | =Nuestra Primera Acción= | ||
− | + | Agreguemosle contenido a la acción '''hola'''. | |
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
− | class SaludoController extends | + | class SaludoController extends ApplicationController { |
public function hola() | public function hola() | ||
{ | { | ||
− | //quitamos el | + | //quitamos el render |
} | } | ||
} | } | ||
+ | |||
</source> | </source> | ||
− | Para poder ver la salida que | + | 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: |
− | Una vez creado este archivo | + | '''app/views/saludo/hola.phtml''' |
+ | |||
+ | Una vez creado este archivo le agregamos un poco de contenido... | ||
<source lang="php"> | <source lang="php"> | ||
− | <h1>Hola | + | <h1>Hola KumbiaPHP</h1> |
</source> | </source> | ||
− | Ahora | + | Ahora si volvemos ejecutar desde nuestro navegador web http://localhost/kumbia/saludo/hola/ si nos debe mostrar el contenido del archivo '''hola.phtml''' obtenemos la siguiente salida. |
− | [[Archivo:Vista_Action_hola.png | + | [[Archivo:Vista_Action_hola.png]] |
− | + | 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= | =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"> | <source lang="php"> | ||
<?php | <?php | ||
− | class SaludoController extends | + | public class SaludoController extends ApplicationController { |
− | |||
public function hola() { | public function hola() { | ||
$this->fecha = date("Y-m-d H:i"); | $this->fecha = date("Y-m-d H:i"); | ||
Línea 121: | Línea 108: | ||
</source> | </source> | ||
− | + | Y la vista hola.phtml quedaría asi: | |
+ | |||
+ | '''app/views/saludo/hola.phtml''' | ||
<source lang="php"> | <source lang="php"> | ||
Línea 128: | Línea 117: | ||
</source> | </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= | =Repitiendo la Historia= | ||
Ahora vamos a crear otra acción llamada '''despedida''', que le dirá adiós a los usuarios: | Ahora vamos a crear otra acción llamada '''despedida''', que le dirá adiós a los usuarios: | ||
− | |||
− | |||
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
− | class SaludoController extends | + | public class SaludoController extends ApplicationController { |
− | |||
public function hola() { | public function hola() { | ||
$this->fecha = date("Y-m-d H:i"); | $this->fecha = date("Y-m-d H:i"); | ||
} | } | ||
− | |||
//dice adios... | //dice adios... | ||
public function adios() | public function adios() | ||
− | { | + | {} |
− | + | ||
} | } | ||
</source> | </source> | ||
− | + | Tal como se menciona arriba creamos una vista con el nombre de la acción en este caso nuestra vista en: | |
+ | |||
+ | '''app/views/saludo/adios.phtml''' | ||
<source lang="php"> | <source lang="php"> | ||
<h1>Adiós</h1> | <h1>Adiós</h1> | ||
− | <?php echo | + | <?php echo link_to('saludo/hola/', 'Volver a Saludar') ?> |
</source> | </source> | ||
− | + | Ahora colocamos en nuestro navegador http://localhost/kumbia/saludo/adios obtendremos un texto y un vinculo hacia nuestro controlador saludo y la acción hola. | |
− | + | '''link_to''', es un helper que ofrece KumbiaPHP para facilitar al momento de programar, este helper es equivalente a hacer | |
− | + | <source lang="html4strict"> | |
− | + | <a href="kumbiaphp/saludo/index">Volver a Saludar</a> | |
− | + | </source> | |
− | + | Esto funciona bien, pero que sucedería si decidimos cambiar el nombre de la aplicación de '''kumbiaphp''' a '''demo''' por ejemplo, significa que deberías cambiar los vínculos de la aplicación para que apunten a la nueva ubicación. |