Crea tu primera App

Resumen

LetPHP se basa en una estructura de Apps, para que los proyectos que realices tengan un orden a nivel de estructura de carpetas, fácil mantenimiento y escalabilidad.

Todas las aplicaciones que desarrolles, las tendrás que crear dentro de la carpeta LetApps, si ya haz descargado e instalado LetPHP te darás cuenta que ya hay una aplicación creada por default llamada app , la puedes utilizar y empezar a escribir el código de tu proyecto o bien puedes crear una nueva aplicación con el nombre que prefieras.

Crear una nueva aplicación

En esta sección vamos a crear una nueva aplicación sin utilizar la que ya teníamos por default, para ello haremos lo siguiente:

  1. Ir a la carpeta LetApps.

  2. Crear una carpeta con el nombre que quieras, para este ejemplo la llamaremos main.

  3. Dentro de main crearemos 2 carpetas.

  4. La primera carpeta la llamaremos Controllers .

  5. A la segunda carpeta la llamaremos Views.

Estructura Básica

Hasta aquí hemos creado la estructura básica de una App, si quieres aprender más sobre los detalles de la estructura de una App, no olvides echarle un vistazo a la sección de la documentación.

Escribiendo tu primer controlador

Los controladores son el punto de arranque de cada App, si buscamos una definición para los controladores, podríamos decir que representan cada página de nuestro proyecto.

Los controladores se van a crear dentro de la carpeta Controllers que se encuentra dentro de nuestra App.

Vamos a crear un archivo dentro de la carpeta llamado index.controller.php, algo importante es que cada que crees un controlador de tener la siguiente sintaxis.

// Ejemplo Sintaxis de un controlador
nombre_controlador.controller.php
// Ejemplo real
index.controller.php

Ya que hemos creado el archivo con la sintaxis correcta, vamos escribir el código necesario que debe tener el archivo del index.controller.php.

Código básico del controlador

// index.controller.php
<?php
namespace LetApps\Main\Controllers;
class Index_Controller
{
	public function start()
	{
		// Funcion para ejecutar el controlador.
	}
}
Explicación:

  • namespace: nombre del espacio donde se encuentra el controlador.

    • LetApps: Carpeta donde se guardan las Apps .
    • Main: Nombre de tu App .
    • Controllers: Carpeta donde guardaras todos los controladores.

  • class: Nombre de la clase , en nuestro ejemplo lo nombramos Index_Controller , lo cual significa que:

    • Index: Nombre del archivo.
    • Es muy importante separar con un _.
    • Controller: Indicamos que es un controlador.

  • function start(): Esta función es obligatoria ya que es la función donde se va a escribir todo el código del controlador y se ejecutará.

Ya que hemos explicado la anatomía del controlador, vamos a hacer un código básico para pasar datos del controlador a la vista.

Código para pasar datos del controlador a la vista

// index.controller.php
<?php

namespace LetApps\Main\Controllers;
class Index_Controller
{
	public function start()
	{
		// Mandamos a llamar a la función View
		$oView = View();	
		// Pasamos los datos a la vista
		$oView
		->setValues([
			'nombre' => 'Rodrigo Ortiz',
			'email' => 'roni@letphp.run',
			'pais' => 'México'
		]);
	}
}

 

Explicación:

Hemos agregado código a la function start().

  • Utilizamos la función View() y la guardamos en la variable $oView
  • Con la ayuda de la función setValues(),que contiene View(), pasamos los datos del controlador a la vista , esto debe de pasarse como un array.

Hemos utilizado View(),y una de sus tantas funciones setValues(), aquí no explicaremos todas las funciones de View(), para eso te recomendamos ir a la sección de la Documentación.

 

Escribiendo tu primera vista

Las vistas son las encargadas de recibir los datos que provienen del controlador  y mostrar el resultado en el navegador.

A continuación veremos el ejemplo de la vista, pero primero debemos de crear un archivo con nombre al igual que el controlador , en este ejemplo será index.view.php.

// EJemplo del archivo.
nombre_vista.view.php
// Ejemplo real, el archivo debe de ser el mismo nombre que el controlador.
index.view.php

 

Código de la Vista

<h3>Tu nombre es: {$nombre}</h3>
<h3>Tu email es: {$email}</h3>
<h3>Tu país es: {$pais}</h3>

 

Explicación

Cómo puedes ver es código HTML , con algo adicional que hay variables entre llaves, esas variables provienen del controlador.

Cambiando App por default

Para ver el resultado de lo que hemos hecho , abre una ventana de tu navegador e indica la ruta donde se encuentra instalado LetPHP.

A primera vista no podrás ver el resultado, por que recuerda que la App por defecto es app , pero como hemos creado una nueva App y la nombramos main , ahora vamos a poner por defecto nuestra App, para que cuando abramos LetPHP en el navegador , se muestre el resultado de nuestra App.

 

Configurando app

Vamos a abrir el archivo de configuraciones del sitio, el cual se encuentra en:

LetCore/configs/site.config.php

Ahora vamos a editar la linea número 50, de la siguiente manera:

// Linea Original
50 | $_CONFIG['main.app_core'] = "app"; // Nombre de la App por default.

// Cambiar a
50 | $_CONFIG['main.app_core'] = "main"; // Nombre de nuestra App.

Guardamos el archivo y recargamos el navegador, ahora si muestra el resultado de nuestra App.

Resultado

Tu nombre es: Rodrigo Ortiz
Tu email es: roni@letphp.run
Tu país es: México

 

Conclusión

Este solo ha sido un ejemplo básico de como crear una aplicación con LetPHP, es un ejemplo muy sencillo pero podrás hacer proyectos desde lo más básico hasta algo más complejo.

Si quieres ver proyectos que se han creado con LetPHP, te recomendamos ir a la sección de Proyectos Creados con LetPHP.

También si quieres ver tutoriales de hacer proyectos más complejos, te recomendamos ir a la sección de Videos.

 

Creado con LetPHP❤️