Criar e implantar um site de documentação Markdown em PHP

Crie um site de documentação PHP que renderize Markdown armazenado no MySQL, envie cabeçalhos de cache e forneça páginas rápidas sem precisar gerenciar Nginx ou certificados.

A stack

• PHP 8.2 com um roteador mínimo ou Laravel
• MySQL para o conteúdo do documento
• Renderização de Markdown no aplicativo
• Ambiente de execução Adios com cache adaptado à borda

Por que esta arquitetura se encaixa na documentação

O PHP renderiza o Markdown publicado, enquanto o MySQL mantém a fonte editável. O aplicativo define cabeçalhos de cache para respostas reutilizáveis, e o Adios fornece o ambiente de execução, roteamento, TLS, logs e comportamento de cache configurado.

1. Compilar o aplicativo

Peça ao agente de IA do 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. Adicionar 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. Implantar e inspecionar

adios up
adios logs --runtime

Abra uma página publicada duas vezes e inspecione os cabeçalhos de resposta na aba de rede do navegador. Seu aplicativo controla a cacheabilidade com Cache-Control ; o Adios gerencia a camada de execução e roteamento.

Consulte a Caminho de implantação PHP, o Verificações de implantação MySQL, e Caminho de implantação Laravel se o aplicativo de documentação usar esse framework.