Download the PHP package dlunamontilla/dltools without Composer

Herramienta DLTools para DLUnire

Versión de la biblioteca

La versión actual de la biblioteca es v0.2.0.

Instalación

Para instalar dlunamontilla/dltools debe escribir el siguiente comando:

Importante: debe tener instalado previamente composer para poder instalar esta herramienta. Si desea instalar composer visite su sitio Web oficial y siga las instrucciones.

Características

Esta herramienta cuenta con lo siguiente:

• Constructor de consultas.
• Modelo.

• Lectura de variables de entorno con tipado estático, a la vez que permite la lectura de las variables de entorno sin archivos de variables de entorno. El analizador sintáctico de las variables de entorno lee el nombre de la variable, el tipo definido y si el valor coincide con el tipo que se indicó en la variable de entorno. Es capaz de verificar la validez de una cadena UUIDv4 y correo electrónico.

  En esta herramienta, el correo electrónico se considera un tipo de datos.

• Parser para archivos que terminen en *.template.html. El motor de plantillas tiene sintaxis muy similar a Laravel.

Similitud con Laravel

Mientras que en el motor de plantillas de Laravel se utiliza la directiva @extends('base') para tomar la plantilla base, en esta herramienta se utiliza la directiva @base('base').

1. Tanto en Laravel como en DLUnire (ya que DLTools se hizo para usar con el framework DLUnire) las plantillas se encuentran en el directorioi /resources/.

2. En Laravel las plantillas terminan en .blade.php, mientras que en DLUnire o DLTools terminan en .template.html.

3. Puede imprimir en pantalla, en formato JSON, al igual que en Laravel un array o un objeto así:

   Se utilizó como segundo argumento 'pretty' para indicar que debe imprimirse formateado.

4. También puede incluir archivos markdown utilizando la directiva @markdown('vista'), sin extensiones, ya que la extensión .md se lo agrega directamente la directiva.

   Puede establecer la ruta de la misma forma que se hace con la función view().

   Ejemplo de código para incorporar archivos markdown como parte del código HTML ya parseado:

   Tome e cuenta que los archivos Markdown se guardan también en el directorio /resources/, es decir, en la misma ruta que las plantilas .template.html.

   Cuando cree su archivo Markdown a incluir en la plantilla no olvide colocarle la extensión .md al momento de crear el archivo, pero no agrege la extensión en la directiva @markdown, ya que ella se encarga de ello.

   Para la directiva @markdown los puntos (.) son separadores de rutas.

5. Ciclos:

   Para definir ciclos o bucles en .template.html se hace de la misma forma que en Laravel, es decir:

Importante

La documentación todavía no está completa y se está trabajando para terminarla.

Para establecer variables de entorno para autenticar su aplicación con el motor de base de datos, cree un archivo con el nombre .env.type y coloque las siguientes líneas:

Si además necesita enviar correos electrónicos, pegue las siguientes líneas:

Importante: para el resaltado de sintaxis, instale DL Typed Environment

Si desea instalar las API Key de Google para implementar un reCAPTCHA, puede agregar las siguientes líneas en el archivo .env.type:

Uso de la herramienta

Modelos

Si desea crear una clase extendida en un modelo, debe escribir las siguientes líneas:

Donde Products es la clase que hace referencia a la tabla products o dl_products si en la variable de entorno se define el prefijo dl_ de esta forma: DLPREFIX: string = "dl". Si las tablas de la aplicación usan prefijos, por ejemplo, wp_, entonces deberá definir el prefijo en el archivo .env.type:

Si en el modelo Products desea establecer un nombre de tabla diferente, solo tiene que definirla así:

En el modelo puede agregar una subconsulta así:

Y DLTools detectará de que se trata de una subconsulta automáticamente.

Interacción con la base de datos desde un controlador

Creación de registros

Envío de correos electrónicos

Esta herramienta utiliza PHPMailer para enviar correos electrónicos.

Sistema de autenticación

Documentación

Esta documentación se irá actualizando progresivamente sobre el uso completo de esta herramienta.

La herramienta DLTools tiene funcionalidades muy extensas para ser documentada en tiempos muy breves.