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:
Ir a la carpeta
LetApps
.Crear una carpeta con el nombre que quieras, para este ejemplo la llamaremos
main
.Dentro de
main
crearemos 2 carpetas.La primera carpeta la llamaremos
Controllers
.A la segunda carpeta la llamaremos
Views
.
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 lasApps
.Main:
Nombre de tuApp
.Controllers:
Carpeta donde guardaras todos loscontroladores
.
class:
Nombre de la clase , en nuestro ejemplo lo nombramosIndex_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 contieneView()
, pasamos los datos del controlador a la vista , esto debe de pasarse como unarray
.
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.