Crear y desplegar un sitio de documentación Markdown en PHP

Crea un sitio de documentación en PHP que renderice Markdown desde MySQL, envíe cabeceras de caché y sirva páginas rápidas sin gestionar Nginx ni certificados.

El Stack

• PHP 8.2 con un router mínimo o Laravel
• MySQL para el contenido de documentos
• Renderizado de Markdown en la app
• Entorno de ejecución de Adios con comportamiento de caché adaptado al borde de la red

Por qué esta arquitectura encaja con la documentación

PHP renderiza el Markdown publicado mientras MySQL conserva el código fuente editable. La aplicación establece cabeceras de caché para las respuestas que pueden reutilizarse, y Adios proporciona el entorno de ejecución, enrutamiento, TLS, registros y comportamiento de caché configurado.

1. Crear la aplicación

Pídele al agente de IA de Adios:

Build a PHP documentation app. Load Markdown pages from MySQL, render them as
HTML, add a sidebar, set Cache-Control headers for published pages, and expose
/healthz.

2. Añadir adios.yaml

name: php-docs
region: de
replicas: 1
routable: true

build_cmd: composer install --no-dev --optimize-autoloader
start_cmd: php -S 0.0.0.0:$PORT public/index.php

runtime:
  name: php@8.2
  port: 8080
  health_path: /healthz
  memory_mb: 512

cache:
  enabled: true
  ttl_seconds: 300
  methods:
    - GET

env:
  DATABASE_URL: secret://DATABASE_URL

requires:
  - db

3. Desplegar e inspeccionar

adios up
adios logs --runtime

Abre dos veces una página publicada e inspecciona las cabeceras de respuesta en la pestaña de red del navegador. Tu app controla si se puede almacenar en caché mediante Cache-Control; Adios se encarga de la capa de ejecución y enrutamiento.

Revisa la Ruta de despliegue de PHP, el Comprobaciones de despliegue de MySQL, y Ruta de despliegue de Laravel si la aplicación de la documentación utiliza ese marco.