Créer et déployer un site de documentation Markdown en PHP

Crée un site de documentation PHP qui rend du Markdown stocké dans MySQL, envoie des en-têtes de cache et sert rapidement les pages sans gérer Nginx ni les certificats.

La stack

• PHP 8.2 avec un routeur minimal ou Laravel
• MySQL pour le contenu du document
• Rendu Markdown dans l’application
• Environnement d’exécution Adios et cache en périphérie

Pourquoi cette architecture convient à la documentation

PHP rend le Markdown publié tandis que MySQL conserve le code source modifiable. L’application définit les en-têtes de cache pour les réponses réutilisables, et Adios fournit l’environnement d’exécution, le routage, TLS, les journaux et le comportement de cache configuré.

1. Créer l’application

Demandez à l’agent 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. Ajouter 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. Déployer et inspecter

adios up
adios logs --runtime

Ouvrez deux fois une page publiée et inspectez les en-têtes de réponse dans l’onglet réseau du navigateur. Votre application contrôle la mise en cache avec Cache-Control; Adios gère la couche d'exécution et de routage.

Consultez la Parcours de déploiement PHP, le Vérifications de déploiement MySQL, et le Parcours de déploiement Laravel si l’application de documentation utilise ce framework.