Enrutado
FacturaScripts almacena las rutas disponibles en el archivo MyFiles/routes.json. Este archivo se actualiza automáticamente cada vez que se instala, desinstala o actualiza un plugin. También al reconstruir.
Enrutado automático
Por defecto FacturaScripts asigna una ruta a cada controlador, con el nombre del propio controlador. Por ejemplo: la ruta /ListProducto ejecuta el controlador ListProducto.php
Rutas especiales
Existen algunas rutas especiales que añade directamente el kernel:
/api: ejecuta la API./Core/Assets/*: ejecuta el controlador Files./cron: ejecuta el cron de cada plugin./deploy: reconstruye la carpeta Dinamic y el archivo de rutas, siempre que no exista ya el directorio Dinamic./Dinamic/Assets/*: ejecuta el controlador Files./install: ejecuta el instalador./login: ejecuta el formulario de login./MyFiles/*: ejecuta el controlador Myfiles, que filtra que no se accedan a archivos confidenciales sin el correspondiente token de autorización./node_modules/*: ejecuta el controlador Files./Plugins/*: ejecuta el controlador Files.
Enrutado manual
Pero también podemos añadir rutas personalizadas llamando directamente a Kernel::addRoute(). Por ejemplo, vamos a hacer que el controlador ListProducto.php también se ejecute para la ruta /productos:
use FacturaScripts\Core\Kernel;
Kernel::addRoute('/productos', 'ListProducto');Si queremos hacer esto en nuestro plugin, lo ideal es colocar esta llamada en la función init() del archivo Init.php del plugin. También podemos añadir una función a ejecutar cada vez que se reconstruya el archivo de rutas, por ejemplo para tener más control:
Kernel::addRoutes(function () {
// tu código aquí
// por ejemplo, puedes leer de una tabla y después, para cada registro, llamar a la función addRoute()
// Kernel::addRoute(...);
});Prioridades en las rutas
Podemos controlar las prioridades en las rutas, es decir, que una ruta tenga preferencia sobre otra, con el tercer parámetro, position: por defecto es 0. Las rutas se ordenan de menor posición a mayor. Si pones un número mayor, la ruta va después de todas las rutas con posición 0, y si pones un número menor, va antes que el resto.
Kernel::addRoute('/productos/*', 'ProductoController'); // esta ruta va primero
Kernel::addRoute('/productos/mios/*', 'MiProductoController'); // esta ruta va despuésEn este ejemplo, cuando accedamos a la ruta /productos/mios/1 se ejecutará el controlador ProductoController, porque esa ruta es compatible y se ha añadido antes. Si queremos que la segunda ruta se evalúe antes, podemos ponerle una posición -1:
Kernel::addRoute('/productos/*', 'ProductoController');
Kernel::addRoute('/productos/mios/*', 'MiProductoController', -1); // esta ruta va antes que el restoAhora al entrar en la ruta /productos/mios/1 se ejecutará el controlador MiProductoController, ya que esa ruta se ha añadido con una posición anterior a la primera. Recuerda: las rutas se ordenan de menor a mayor posición.