Download the PHP package dlunamontilla/dlunire without Composer

Bienvenido a este Mini Framework PHP

Importante: la documentación aún no se ha terminado. En la medida de lo posible, iré actualizando la documentación de cómo funciona esta herramienta. De hecho, cuenta con un motor de plantillas similar a Laravel y cuenta con directivas.

Puede obtener el Framework aqui o escribiendo el siguiente comando en la terminal:

Antes de usar esta herramienta, debes instalar una extensión para Visual Studio Code para obtener el resaltador de sintaxis de las variables de entorno con tipos estáticos. El nombre del archivo para variables de entorno que debe crear es .env.type.

Instalación del resaltador de sintaxis de las Variables de Entorno

Vaya al instalador de extensiones de Visual Studio Code y busque DL Typed Environment y si no aparece, visite este enlace para descargar la extensión.

Instalación de SASS

Para escribir código SCSS debe instalar SASS escribiendo el siguiente comando:

Directorios | Estructura

Instalación

Para crear una aplicación con esta herramienta, debe escribir el siguiente comando:

Y luego, del paso anterior, solo tienes que correrla:

Directorio de ejecución de la aplicación

El directorio de ejecutución de la aplicación es public/, pero puedes cambiar su nombre si así lo desea, pero asegúrate que siempre apunte al directorio que hayas utilizado como directorio de ejecución de la aplicación.

Si cambias el nombre, también debes cambiar:

Por esta:

Sin embargo, siempre se recomienda dejarle el mismo nombre al directorio.

Métodos HTTP soportados, por ahora

Los métodos HTTP que soporta este mini-framework son: GET, POST, PUT, PATCH y DELETE

Definición de rutas

Tienes tres formas de definir las rutas con esta herramienta, pero antes, debes conocer dónde se definen las rutas.

Las rutas las puedes definir en cualquier en cualquier archivo ubicado en el directorio /routes que se encuentra ubicado en el directorio raíz de la aplicación.

Aquí tenemos tres formas de definirnas

1. Pasando como segundo argumento una cadena de texto:

   De esa manera, se estará apuntando al controlador que se encuentra en la ruta app/Controllers/TestController.php, a la vez, que se ejecuta el método method.

2. Pasando el segundo argumento como un callback:

   También puede pasar parámetros en la ruta:

3. La tercera forma, es pasando un array como segundo argumento:

Esta forma, aparte de ser más elegante, más potente. Tanto en la primera y tercera manera de definir las rutas, se pueden pasar parámetros y capturar de forma automática peticiones del usuario al momento de definir el controlador.

También se pueden subir archivos de forma simple con filtrado por tipos incluidos.

Definición de controladores

Vamos a ver cómo definir un controlador, para ello debemos escribir las siguientes líneas:

Tome en cuenta, que el parámetro $param es opcional. No está obligado a definirlo.

Cada controlador que defina debe estar ubicado, preferiblemente en el directorio /app/Controllers. No importa, si los controladores que defina en esa ruta estén en subdirectorios.

Los parámetros definidos en $param son los que se han definido en una ruta similar a esta:

Captura de valores desde el controlador

Puede capturar valores desde el controlador de la petición, sin tener que escribir $_GET, $_POST o $_REQUEST de esta manera:

El contenido de $values es un array asociativo, donde la clave es el nombre del campo del formulario o JSON, si se envió un JSON o el valor, obviamente, el contenido del campo del formulario

Validación de entradas del usuario

Si quiere recibir una entrada de usuario, como por ejemplo, un correo electrónico, una cadena UUID u otro formato, puede escribir las siguientes líneas:

Creación de Modelos

Para crear un modelo, puede escribir las siguientes líneas en un archivo que se ubique en app/Models:

No hace falta definir algo más, a menos que desee agregar funcionalidades personalizadas.

Cuando se define una clase llamada Tabla extendida en un modelo, DLUnire será capaz de mapear el nombre de la tabla, por ejemplo, si la clase se llama Tabla, entonces, apuntará de forma automática a tabla y si tiene prefijo las tablas deberá indicarlo en las variables de entorno con tipos estáticos (lo veremos más adelante).

Si desea que su clase Tabla apunte a otra tabla, solo tiene que definirla de esta forma:

Y eso es todo. No necesita hacer más cosas.

¿Cómo uso el modelo para interactuar con la base de datos?

Para interactuar con la base de datos usando el model que recién creó, solo debe llamar a sus métodos disponibles, en función del contexto en el que se encuentre, por ejemplo, es va a obtener una lista de usuarios.

Para obtener una lista de usuarios, asegúrese de que su clase sea PascalCase con el nombre de la tabla usuarios, por ejemplo:

Y luego, consulta la lista de usuarios de esta forma:

También, puede consultar la lista de usuarios con paginación incluida de esta forma:

Continuará

Por ahora, lo dejo hasta aquí. Me queda mucho camino por recorrer para terminar de hacer este tutorial, ya que el proyecto es bastante extenso.