Formats des fichiers de redirection
Chaque build écrit des règles de redirection dans des fichiers à la racine de sortie. Leurs formats dépendent du serveur web ou du produit d'hébergement qui les lit, donc cette page décrit les deux, et la seule ligne qui ne fonctionne que sur Caddy.
Les trois fichiers
_redirects(racine de sortie) : règles au format Netlify, une par ligne :old-path new-path status-code. Écrites depuis vos réglages de redirections (redirections de slug avec le code de statut que vous avez choisi par règle)._redirects.caddy(racine de sortie) : les mêmes redirections de slug exprimées dans la syntaxe native de la directiveredirde Caddy, avec un commentaire d'en-tête vous disant d'inclure le snippet dans le bloc de site de votre Caddyfile. Généré seulement quand votre Site URL est définie.- Le bloc de domaine canonique ajouté dans
_redirectsquand une Site URL est configurée : une seule règle qui fait un 301 de l'hôte alternatif www/nue vers votre hôte canonique, chemin intact.
Ce que sont les règles
- Redirections de slug: vos règles de redirection (ancien slug/nouveau slug par langue/type), émises seulement quand l'ancienne URL ne résout plus vers du contenu en ligne ; une redirection que vous configurez contre une adresse qui est encore une page/post en ligne est supprimée pour que les URL établies restent joignables.
- Redirections de changement de préfixe: un changement automatique de préfixe de post (par ex. le préfixe du blog) écrit les anciens chemins
blog/<slug>/ …vers la nouvelle structure. - Codes de statut: 301, 302, ou 307 comme choisi par règle ; 301 quand non défini.
Note de syntaxe Caddy uniquement
La ligne de domaine canonique utilise le marqueur de force externe redir de Caddy (301!). Un analyseur strictement compatible Netlify traite ce caractère final comme faisant partie de la cible ; quand vous publiez l'arborescence de sortie vers un hébergeur autre que Caddy, relisez ce bloc. Les lignes de redirection de slug (format Netlify) elles-mêmes sont de simples paires de chemins qu'un large support d'hébergeurs gère.
Ce qui est délibérément pas dans les fichiers
Les redirections de motif (jokers * avec substitutions $1) ne sont jamais écrites dans ces fichiers : les formats simples ne peuvent pas les exprimer en sécurité. Les redirections de motif exigent des règles implémentées dans votre configuration de reverse proxy.
Référencer le snippet Caddy
import /var/www/chinaski1/output/_redirects.caddy(Chemin d'inclusion comme le commentaire d'en-tête propre du fichier l'indique ; le style d'inclusion exact est la note d'en-tête propre du snippet.)