# El controlador y la pila de Devkron El servidor FastCGI de Devkron no decide por sí mismo qué hacer con una petición: ejecuta un programa DKL, el **controlador**, indicado en la llave `controller` de `fastcgi.json` (en la distribución, `fastcgi/http.dkl`). Como el controlador es código DKL, se puede leer y ajustar. Esta página describe sus piezas, las variables que se pueden configurar y el vocabulario de despliegue que se usa en el resto de la documentación. ## Los archivos de fastcgi/ | Archivo | Qué hace | Lo modifica para | |---|---|---| | `http.dkl` | Arma la ruta del sitio, aplica los demás programas en orden, ejecuta el programa o entrega el archivo estático, atiende los errores | Cambiar las variables generales (abajo), las extensiones ejecutables o los documentos predeterminados | | `alias.dkl` | Recibe la variable `host` y puede cambiarla | Que varios nombres de host usen la misma carpeta (`www.ejemplo.com` → `ejemplo.com`) | | `mime.dkl` | Define los tipos de contenido de los archivos estáticos | Agregar extensiones (`.svg`, `.webp`, `.woff2`...) | | `routing.dkl` | Aplica `ext.map`, `routes.map`, `paths.map` y `routing.dk` del sitio | Reglas de enrutamiento para todos los sitios del servidor | | `auth.dkl` | Restringe la carpeta protegida (si se activó) y ejecuta el `auth.dk` del sitio | Autorización común a todos los sitios | | `render.dkl` | Ejecuta el `render.dk` del sitio | Post-procesamiento común a todos los sitios | | `404.dkl` | Página para un recurso que no existe (estado 404) | Su propia página de "no encontrado" | | `500.dkl` | Página para una excepción no atendida (estado 500, con el mensaje en `@http_context/last_error`) | Su propia página de error, sin detalles técnicos | El orden completo de una petición está en [Servidor web](/es/devkron/2.0/marcos/servidor-web/). Si modifica algún archivo de `fastcgi/`, guarde una copia: al actualizar Devkron la distribución trae los suyos. Los cambios a archivos `.dkl` se aplican en la siguiente petición, sin reiniciar el servicio. ### alias.dkl ```dkl #! switch tolower(host) { case "www.tienda.ejemplo.com" { host = "tienda.ejemplo.com" } } ``` ### mime.dkl Los tipos `text` se leen como texto y los `binary` se entregan como bytes: ```dkl #! using mime_extensions { member @"text" { member @".txt" { } member @".htm" { @"content-type": "text/html;charset=utf-8"} member @".html"{ @"content-type": "text/html;charset=utf-8"} member @".css"{ @"content-type": "text/css;charset=utf-8"} member @".js"{ @"content-type": "application/javascript;charset=utf-8"} } member @"binary" { member @".jpg" { @"content-type": "image/jpeg" } member @".jpeg" { @"content-type": "image/jpeg" } member @".png" { @"content-type": "image/png" } member @".pdf" { @"content-type": "application/pdf" } } } ``` Las extensiones que no están en la lista se entregan como `application/octet-stream` (comprobado con `.gif` y `.md`). Si su sitio sirve imágenes `.svg`, fuentes o `.json` estáticos, agréguelos aquí. Para sitios con mucho contenido estático, lo más eficiente es que nginx entregue esos archivos directamente (`location /assets/ { root ...; }`) y pase a Devkron solo lo dinámico. ## Variables de http.dkl Al inicio de `http.dkl`: | Variable | Valor en la distribución | Uso | |---|---|---| | `@http_500` | `"500.dkl"` | Programa de la página de error | | `@http_404` | `"404.dkl"` | Programa de la página de "no encontrado" | | `@http_protected_dir` | `"_protected"` | Nombre de la carpeta protegida de los sitios | | `@http_restrict_protected_dir` | `@false` | `@true` responde "Acceso prohibido" a cualquier URL dentro de la carpeta protegida. Vea [La carpeta protegida](/es/devkron/2.0/marcos/servidor-web/enrutamiento.md#la-carpeta-protegida) | | `@http_casesensitive` | `@false` | Si los mapas de rutas distinguen mayúsculas. Con `@false`, los valores de los parámetros de `routes.map` llegan en minúsculas | | `@prefix_uri_params` | `""` | Prefijo para los parámetros que agrega `routes.map` a `request/get` | | `errordet(@true)` | activo | Muestra el detalle de depuración (código y línea) en los mensajes de error. Cada petición puede apagarlo con `do errordet(@false)` | Dentro de la función `__http_handler` están también: | Variable | Valor | Uso | |---|---|---| | `base_path` | `"web"` | Carpeta raíz de todos los sitios | | `default_doc` | `index.dkl,index.html,index.htm,index.txt,default.dkl,default.html,default.htm,default.txt,readme.md` | Documentos predeterminados, en orden | | `dkl_ext` | `".dkl"` | Extensiones que se ejecutan | | `restricted` | `".dk,.dkh"` | Extensiones que no se entregan como archivo estático | | `unrestricted` | `"*"` | Extensiones permitidas (`*` = todas las no restringidas) | ## La pila de Devkron La **pila** (*stack*) de Devkron es el conjunto que sostiene un sitio, una aplicación o un servicio: el sistema operativo, el servidor web, el servidor de bases de datos y el servidor Devkron. Pila de Devkron y despliegue con varias instancias detrás de un proxy web Términos que se usan en la documentación de instalación y operación: | Término | Significado | |---|---| | **Despliegue** (*deployment*) | La instalación del software (Devkron, MySQL...) en una carpeta de un servidor físico o virtual, por ejemplo `/opt/devkron` | | **Instancia** (*instance*) | Un proceso en ejecución a partir de un despliegue: cada `dkl -fastcgi archivo.json` es una instancia | | **Conexión** (*connection*) | La atención de una petición y su respuesta, a cargo de un hilo de una instancia. `max_concurrent_requests` limita cuántas atiende una instancia a la vez | | **Servidor ascendente** (*upstream server*) | Un servidor que da servicio a otro servidor; para nginx, cada instancia de Devkron es un servidor ascendente | | **Grupo de servidores ascendentes** (*upstream*) | Varias instancias que el servidor web usa con equilibrio de carga o tolerancia a fallos (el bloque `upstream` de nginx) | | **Proxy web** | El servidor web que recibe HTTP y lo reparte entre los servidores ascendentes; solo se encarga del protocolo HTTP, el equilibrio de carga y la tolerancia a fallos | Cómo se configuran el servicio, los sockets, nginx con varias instancias e IIS está en [Instalación y configuración](/es/devkron/2.0/instalacion/). ## Los marcos y el servidor Los marcos de dkl-web no cambian el controlador: se apoyan en sus puntos de extensión. | Marco | Se conecta al servidor por | |---|---| | [website.dkl](/es/devkron/2.0/marcos/sitios/) | Lee `request/headers/PATH_TRANSLATED` para buscar plantillas y archivos `config.dk`/`lib.dk` desde la carpeta del programa | | [Autenticación](/es/devkron/2.0/marcos/autenticacion/) | Un `auth.dk` en la carpeta protegida que arma `@http_context/session` | | [CRUD-L](/es/devkron/2.0/marcos/crudl/) | Una regla de `routes.map` que manda las URL de las entidades a un `entry-point.dkl` | | [API FSO](/es/devkron/2.0/marcos/fso/) | Una regla de `ext.map` (`.fso > $fso/fso.*.dkl`) y los manifiestos de privilegios que también lee `auth.dk` | | [uie](/es/devkron/2.0/marcos/uie/) y [Websencia](/es/devkron/2.0/marcos/websencia/) | Nada: son bibliotecas que producen HTML dentro de su programa |