# Arquitectura de Devkron 2.0 Esta página explica cómo se arman las piezas de Devkron: qué hace cada una, dónde vive en la instalación y cuándo interviene. Conocerla ayuda a ubicar un problema (¿es nginx, el servidor FastCGI, el programa o la base de datos?) y a decidir qué configurar. Piezas de Devkron 2.0: nginx o IIS pasan las peticiones por FastCGI al servidor de dkl; el controlador HTTP en DKL elige el programa; el intérprete lo ejecuta usando bibliotecas, marcos y la capa de datos con sus adaptadores ## Un solo ejecutable: `dkl` Todo Devkron se ejecuta con un solo programa, `dkl` (`dkl.exe` en Windows), autónomo: trae su propio runtime y no requiere instalar nada más: | Modo | Comando | Para qué | |---|---|---| | Consola | `dkl programa.dkl [opciones]` | tareas, reportes, procesos por lotes, pruebas | | Servidor FastCGI | `dkl -fastcgi fastcgi.json` | sitios y servicios web detrás de nginx o IIS | | Licencia | `dkl -license` | ver la licencia instalada | | Cifrar fuentes | `dkl -crypto archivo` | distribuir un programa sin su código legible | Las opciones están en [Ejecutar programas de consola](/es/devkron/2.0/instalacion/consola.md). ## El intérprete El intérprete lee el archivo `.dkl` y los que incluye con `#include`, los **analiza** (los convierte en un árbol de elementos, como un XML) y **ejecuta** la parte imperativa. Lo declarativo que se imprime forma la **salida** del programa: en la consola se muestra; en el servidor web es el cuerpo de la respuesta. En 2.0 el intérprete hace tres cosas que lo vuelven mucho más rápido sin que usted cambie su código: - **Caché del árbol analizado**: en el servidor FastCGI cada archivo se analiza una sola vez y se revalida si cambia. Editar un `.dkl` en caliente sigue funcionando. - **Salida directa**: lo que el programa imprime se escribe directo a un búfer, en lugar de construir el árbol y serializarlo al final. La salida es idéntica byte por byte. - **Compilación a código nativo** (opcional, apagada por omisión en el servidor): compila los programas a código nativo y los guarda en una caché firmada. Detalle y cuándo encender cada una en [Rendimiento y compilación nativa](/es/devkron/2.0/migracion/rendimiento.md). ## El servidor FastCGI FastCGI es el protocolo con el que un servidor web (nginx, IIS) le pasa cada petición a un proceso que la atiende. `dkl -fastcgi` abre un **socket Unix** o un **puerto TCP**, recibe las peticiones y las atiende en paralelo, cada una aislada de las demás. El servidor de 2.0 es propio, sin dependencias de otros servidores web: soporta socket Unix e IPv6, límites de tamaño del cuerpo y de los encabezados, tiempos de espera reales y envía el código HTTP que fija el programa. Se configura con `fastcgi.json`: vea [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md). ## El controlador HTTP El servidor FastCGI no decide qué archivo ejecutar: eso lo hace un **programa DKL**, el controlador (`fastcgi/http.dkl`), que se ejecuta en cada petición. Con el host y la URI de la petición: 1. elige la carpeta del sitio (`web//`, o `web/` si no hay una para ese host); 2. aplica los alias de host (`fastcgi/alias.dkl`) y el enrutamiento (`fastcgi/routing.dkl`, `routes.map`, `ext.map`, `paths.map`); 3. busca el documento predeterminado (`index.dkl`, `index.html`…) y aplica la autorización (`auth.dk`); 4. entrega el archivo estático con su tipo MIME (`fastcgi/mime.dkl`) o **ejecuta** el `.dkl`; 5. si el programa falla, responde la página de error (`fastcgi/500.dkl`) con estado 500; si no existe, la de `fastcgi/404.dkl`. Como el controlador está escrito en DKL, se puede adaptar. Cómo programar sobre este flujo (`@http_context`, mapas de rutas, respuestas HTML, JSON o archivos) está en [Servidor web](/es/devkron/2.0/marcos/servidor-web/). ## Las bibliotecas Las bibliotecas son archivos `.dkh` que se incluyen con `#include` y, casi siempre, una DLL de .NET que hace el trabajo: | Grupo | Ejemplos | Dónde | |---|---|---| | Del motor | `functions.dkh`, `serialize.dkh` (JSON y XML), `dbr.dkh` (bases de datos), `webcl.dkh` (HTTP y correo) | vienen con la distribución | | Estándar nuevas de 2.0 | `http.dkh`, `threads.dkh`, `zip.dkh`, `time.dkh`, `hash.dkh`… | vienen con la distribución | | De terceros | `csv.dkh`, `xlsx.dkh`, `image.dkh`, `markdown.dkh`… | se instalan aparte | | Extensiones propias | cualquier DLL que su aplicación cargue con `_import_library` | junto a `dkl` | Vea [Bibliotecas](/es/devkron/2.0/bibliotecas/) y, para instalarlas, [Extensiones .NET](/es/devkron/2.0/instalacion/extensiones-net.md) y [Bibliotecas de terceros y marcos](/es/devkron/2.0/instalacion/bibliotecas-y-marcos.md). ## Los marcos de trabajo Un marco es un conjunto de programas DKL que resuelve un tipo de aplicación completo: **CRUD-L** (altas, bajas, cambios, consultas y listas sobre tablas), **FSO** (operaciones con archivos por HTTP), **webauth** (autenticación), **website** y los componentes de interfaz `uie`. Se publican en el repositorio `dkl-web` y se copian en la carpeta de Devkron. Vea [Marcos de trabajo](/es/devkron/2.0/marcos/). ## La capa de datos y los adaptadores `dbr.dkh` es la biblioteca para bases de datos relacionales. No se conecta directamente: busca el **nombre cualificado** de la conexión (`ventas@miapp`) en el repositorio `connections.xml`, y el **adaptador** del motor correspondiente, registrado en `adapters.xml`, hace el trabajo: | Motor | Adaptador | Versiones probadas en 2.0 | |---|---|---| | MySQL | `MySqlAdapter.dll` | 8.0 en adelante | | SQL Server | `SQLSvrAdapter.dll` | 2017, 2019 y 2022 | | PostgreSQL | `PostgreAdapter.dll` | 16 | | Firebird | `FirebirdSqlAdapter.dll` | 2.5, 3.0, 4.0 y 5.0 | Así, el mismo programa cambia de servidor de base de datos con solo editar `connections.xml`. Vea [Conexiones a bases de datos](/es/devkron/2.0/instalacion/conexiones.md). ## Dónde está cada pieza en la instalación ```text /opt/devkron/ (C:\devkron en Windows; algunas instalaciones usan /usr/devkron) ├── dkl ejecutable: consola y servidor FastCGI ├── Devkron*.dll, *Adapter.dll motor, bibliotecas, adaptadores y drivers ├── System.*.dll, lib*.so runtime incluido en la distribución ├── dkli.dkh, functions.dkh … cabeceras DKL ├── fastcgi.json configuración del servidor FastCGI ├── fastcgi/ controlador HTTP en DKL ├── web/ sitios: web// o web/ para el sitio predeterminado ├── adapters.xml adaptadores registrados ├── connections.xml conexiones (lo crea usted) └── devkron.license licencia (la instala usted) ``` La lista completa de archivos está en [Instalar en Linux](/es/devkron/2.0/instalacion/linux.md).