Sviluppa e distribuisci un sito di documentazione Markdown in PHP

Sviluppa un sito di documentazione PHP che renderizza Markdown da MySQL, invia intestazioni di cache e serve pagine veloci senza dover gestire Nginx o certificati.

Lo stack

• PHP 8.2 con un router minimo o Laravel
• MySQL per il contenuto del documento
• Rendering Markdown nell'app
• Ambiente di esecuzione Adios e gestione della cache edge

Perché questa architettura si adatta alla documentazione

PHP renderizza il Markdown pubblicato, mentre MySQL conserva la sorgente modificabile. L’applicazione imposta le intestazioni di cache per le risposte riutilizzabili e Adios fornisce ambiente di esecuzione, instradamento, TLS, log e comportamento della cache configurato.

1. Sviluppa l’app

Chiedi all’agente IA 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. Aggiungi 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. Distribuisci ed esamina

adios up
adios logs --runtime

Apri due volte una pagina pubblicata e controlla le intestazioni delle risposte nella scheda di rete del browser. La tua app controlla quali risposte possono essere memorizzate in cache tramite Cache-Control; Adios gestisce il livello di esecuzione e instradamento.

Consulta percorso di distribuzione PHP, il verifiche di distribuzione MySQL, e il percorso di distribuzione Laravel se l’applicazione di documentazione usa quel framework.