# Primer sitio web paso a paso En esta guía publicará un sitio con una página HTML y un servicio JSON, servidos por nginx y el servidor FastCGI de Devkron 2.0, en su propio equipo y sin licencia. Al terminar sabrá dónde van los archivos de un sitio, cómo se arranca el servidor y cómo comprobar que responde. Requisitos: Devkron 2.0 instalado ([Linux](/es/devkron/2.0/instalacion/linux.md) o [Windows](/es/devkron/2.0/instalacion/windows.md)) y nginx. Los ejemplos usan `/opt/devkron`; en Windows, `C:\devkron`. ## 1. Cree la carpeta del sitio El servidor busca cada sitio en `web//` dentro de la carpeta de Devkron. Sin licencia solo atiende hosts `*.localhost` y `127.0.0.1`, así que use `misitio.localhost` (no requiere editar el archivo `hosts`): ```bash sudo mkdir -p /opt/devkron/web/misitio.localhost/api ``` ## 2. Escriba una página HTML `/opt/devkron/web/misitio.localhost/index.dkl`: ```dkl #include "dkli.dkh" #set "meta-xml-declaration" "" #! program "inicio" { #include "functions.dkh" @http_context<"response/headers/Content-Type">: "text/html;charset=utf-8" ref q = @@(@http_context, "&request/get") nombre = field.dstr(q, "nombre", "visitante") total = 1234.5 ## html { head { title { "Mi primer sitio" } } body { h1 { "Hola, #" } p { "Total del día: #" } p { a(href="/api/productos.dkl") { "Ver productos en JSON" } } } } ## } ``` - `@http_context` es el registro con la petición (`request/…`) y la respuesta (`response/…`). `request/get` trae los parámetros de la URL. - Entre `##` y `##` está la parte declarativa: los elementos se convierten en HTML. - `#` inserta el valor de una variable en el texto, y `#` lo formatea. El texto normal se escapa para HTML (un `` llega como `<b>`). - `#set "meta-xml-declaration"` cambia la primera línea de la salida (en vez de ``). ## 3. Escriba un servicio JSON `/opt/devkron/web/misitio.localhost/api/productos.dkl`: ```dkl #include "dkli.dkh" #! program "productos" { #include "functions.dkh" #include "serialize.dkh" new respuesta {$$ "ok": true, "productos": [ {"clave": "P-01", "nombre": "Lápiz", "precio": 5.5}, {"clave": "P-02", "nombre": "Goma", "precio": 3} ] $$} @http_context<"response/headers/Content-Type">: "application/json;charset=utf-8" @http_context<"response/output">: "text" @http_context<"response/text">: to.json(respuesta) } ``` En un servicio real, `respuesta` saldría de una consulta a la base de datos (vea [Conexiones a bases de datos](/es/devkron/2.0/instalacion/conexiones.md)). Las formas de responder HTML, JSON o archivos y todo el contenido de `@http_context` están en [Servidor web](/es/devkron/2.0/marcos/servidor-web/). ## 4. Configure y arranque el servidor FastCGI Para esta prueba basta un `fastcgi.json` que escuche solo en la máquina local. Edite `/opt/devkron/fastcgi.json`: ```json { "controller": "fastcgi/http.dkl", "address": "127.0.0.1", "port": 9090, "max_concurrent_requests": 3, "culture": "es-MX" } ``` Arránquelo **desde la carpeta de Devkron** (el controlador y la carpeta `web` se buscan relativos al directorio de trabajo): ```bash cd /opt/devkron ./dkl -fastcgi fastcgi.json ``` ```powershell cd C:\devkron .\dkl.exe -fastcgi fastcgi.json ``` Déjelo corriendo en esa terminal; `Ctrl+C` lo detiene. Para dejarlo como servicio vea [Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md) o [Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md). ## 5. Configure nginx Agregue un `server` a la configuración de nginx (en Linux, por ejemplo `/etc/nginx/conf.d/misitio.conf`; en Windows, dentro de `http { }` de `conf\nginx.conf`): ```nginx server { listen 80; server_name misitio.localhost; location / { include fastcgi_params; fastcgi_pass 127.0.0.1:9090; } } ``` Compruebe la configuración y recárguela: ```bash sudo nginx -t && sudo systemctl reload nginx ``` ## 6. Pruebe Abra en el navegador `http://misitio.localhost/?nombre=Ana`, o desde la terminal: ```bash curl "http://misitio.localhost/?nombre=Ana" ``` ```text Mi primer sitio

Hola, Ana

Total del día: 1,234.50

Ver productos en JSON

``` ```bash curl http://misitio.localhost/api/productos.dkl ``` ```text {"ok":true,"productos":[{"clave":"P-01","nombre":"L\u00E1piz","precio":5.5},{"clave":"P-02","nombre":"Goma","precio":3}]} ``` `to.json` escribe los caracteres no ASCII como `\u00E1`; cualquier cliente JSON los lee como `á`. Edite `index.dkl` y recargue la página: el cambio se ve de inmediato, sin reiniciar el servidor. Solo hay que reiniciar al reemplazar una DLL. ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | **502 Bad Gateway** de nginx | el servidor FastCGI no está corriendo, o escucha en otro puerto o socket | arranque `dkl -fastcgi` y revise que `fastcgi_pass` coincida con `address`/`port` (o `unix_socket`) de `fastcgi.json`; vea el `error.log` de nginx | | 502 con `connect() to unix:… failed (13: Permission denied)` en el `error.log` | nginx no tiene permiso sobre el socket Unix | vea los permisos en [Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md) | | **503** "Host no admitido por el servidor, se requiere una licencia." | sin licencia solo se atienden `*.localhost` y `127.0.0.1` | use `misitio.localhost` para pruebas o instale la [licencia](/es/devkron/2.0/instalacion/licencia.md) | | **404** "No se encuentra el recurso solicitado" | la carpeta `web//` no coincide con el host de la petición, o el archivo no existe | revise el nombre de la carpeta y la ruta; si no hay carpeta para el host, se usa `web/` | | **500** "Excepción no controlada" con el mensaje del error | el programa terminó con un error no manejado | corrija el error indicado; en 2.0 la respuesta llega con estado 500 | | la página sale como texto con etiquetas visibles | falta el `Content-Type` | ponga `response/headers/Content-Type` en `text/html;charset=utf-8` | | el servidor no arranca: "Address already in use" | otro proceso usa el puerto 9090 | cambie `port` en `fastcgi.json` y en nginx | ## Siguiente paso - [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md): todas las opciones de `fastcgi.json`. - [nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md): socket Unix, varios sitios, tamaños y tiempos. - [Servidor web](/es/devkron/2.0/marcos/servidor-web/): cómo se programan las páginas y servicios.