Passer au contenu principal
Ce guide couvre les configurations suivantes au niveau du serveur web :

Ajouter des en-têtes de réponse

Les en-têtes de réponse personnalisés vous permettent d’ajouter des instructions d’en-têtes HTTP aux requêtes correspondant à des chemins spécifiques. Un en-tête de réponse est une paire nom-valeur qui fournit des instructions aux navigateurs sur la façon d’interagir avec le contenu demandé. Par exemple, vous pouvez spécifier l’en-tête Access-Control-Allow-Origin pour indiquer quels domaines le navigateur peut accéder pour cette page. Pour créer cette entrée, ajoutez ce qui suit au fichier .replit dans le répertoire racine de votre application Replit :
[[deployment.responseHeaders]]
path = "/*"
name = "Access-Control-Allow-Origin"
value = "origin"
Cet en-tête de réponse comprend les paramètres suivants :
  • path : Modèle de chemin d’URL correspondant aux ressources demandées
  • name : Nom de l’en-tête HTTP
  • value : Valeur de l’en-tête HTTP
Vous pouvez ajouter plusieurs entrées deployment.responseHeaders au fichier .replit. Pour appliquer les mises à jour de configuration, republiez votre application Replit.

En-têtes réservés

Replit réserve les en-têtes HTTP suivants et ne vous permet pas de les configurer.
Accept-Ranges
Age
Allow
Alt-Svc
Connection
Content-Encoding
Content-Length
Content-Range
Date
Location
Server
Set-Cookie
Trailer
Transfer-Encoding
Upgrade
Pour en savoir plus sur les en-têtes HTTP, consultezEn-têtes HTTPdans la documentation web MDN.

Créer une page 404 personnalisée

Une page 404 personnalisée s’affiche lorsque les utilisateurs demandent des chemins d’URL qui ne correspondent à aucun fichier ou règle dans votre application publiée. Pour ajouter une page 404 personnalisée, créez le contenu de la page dans un fichier nommé 404.html dans le répertoire racine de votre application Replit. Lorsque les utilisateurs tentent d’accéder à un chemin d’URL qui n’existe pas, ils voient le rendu HTML de la page 404 personnalisée.

Définir des réécritures de chemins d’URL

Vous pouvez définir des réécritures d’URL pour modifier le chemin d’URL d’une requête avant que votre application Replit ne la traite. L’URL d’origine reste visible dans le navigateur, mais le serveur charge la ressource définie dans la règle de réécriture. Par exemple, vous pouvez spécifier que toutes les requêtes commençant par /app chargent le contenu du fichier /app/index.html. Pour créer cette entrée, ajoutez ce qui suit au fichier .replit dans le répertoire racine de votre application Replit :
[[deployment.rewrites]]
from = "/app/*"
to = "/app/index.html"
  • from : Modèle de chemin d’URL correspondant aux ressources demandées
  • to : Chemin réécrit, qui correspond à un fichier dans votre déploiement statique.
Vous pouvez ajouter plusieurs entrées deployment.rewrites au fichier .replit. Le serveur interprète les entrées dans l’ordre indiqué et ignore les doublons. Pour appliquer les mises à jour de configuration, vous devez republier votre application Replit. Les sections suivantes décrivent les contraintes des règles de réécriture d’URL.

Correspondance de chemin

Les contraintes suivantes s’appliquent aux paramètres from et to dans les règles de réécriture :
  • Les correspondances doivent être exactes sauf si un * est présent
  • Un * correspond au reste d’un chemin
  • Un * n’est valide qu’à la fin du chemin
  • Lorsque vous incluez * dans le paramètre from, vous pouvez l’inclure dans le paramètre to pour représenter la section correspondante du chemin
Par exemple, si votre fichier .replit contient la réécriture suivante :
[[deployment.rewrites]]
from = "/v1/*"
to = "/v2/*"
Lorsqu’un utilisateur visite le chemin /v1/a-propos-de-nous.html, la réécriture sert le fichier situé à /v2/a-propos-de-nous.html.

Masquage

Le masquage se produit lorsqu’une réécriture correspond à un chemin d’URL qui correspond également à un fichier dans votre déploiement statique. Dans ce cas, le serveur cloud ignore la réécriture et sert le fichier directement. Par exemple, supposons que votre application publiée contient les fichiers suivants :
  • index.html
  • about.html
Le fichier .replit contient la réécriture suivante :
[[deployment.rewrites]]
from = "/*"
to = "/index.html"
Lorsqu’un utilisateur visite /register.html, le serveur réécrit la requête vers /index.html et sert ce fichier. Cependant, si un utilisateur visite /about.html, le serveur ignore la réécriture et sert le fichier about.html puisqu’il existe dans votre déploiement statique.

Restrictions de domaine

Les réécritures fonctionnent uniquement pour les requêtes vers le domaine principal de votre déploiement statique et ne peuvent rediriger que vers des fichiers au sein de votre déploiement statique.