Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Este guia abrange as seguintes configurações no nível do servidor web:

Adicionar cabeçalhos de resposta

Os cabeçalhos de resposta personalizados permitem adicionar instruções de cabeçalho HTTP a requisições que correspondem a caminhos específicos. Um cabeçalho de resposta é um par nome-valor que fornece instruções aos navegadores sobre como interagir com o conteúdo solicitado. Por exemplo, você pode especificar o cabeçalho Access-Control-Allow-Origin para indicar quais domínios o navegador pode acessar para aquela página. Para criar esta entrada, adicione o seguinte ao arquivo .replit no diretório raiz do seu Replit App:
[[deployment.responseHeaders]]
path = "/*"
name = "Access-Control-Allow-Origin"
value = "origin"
Este cabeçalho de resposta inclui os seguintes parâmetros:
  • path: Padrão de caminho de URL que corresponde aos recursos solicitados
  • name: Nome do cabeçalho HTTP
  • value: Valor do cabeçalho HTTP
Você pode adicionar várias entradas deployment.responseHeaders ao arquivo .replit. Para aplicar as atualizações de configuração, republique seu Replit App.

Cabeçalhos reservados

O Replit reserva os seguintes cabeçalhos HTTP e não permite que você os configure.
Accept-Ranges
Age
Allow
Alt-Svc
Connection
Content-Encoding
Content-Length
Content-Range
Date
Location
Server
Set-Cookie
Trailer
Transfer-Encoding
Upgrade
Para saber mais sobre cabeçalhos HTTP, consulteHTTP headersna documentação web do MDN.

Criar uma página 404 personalizada

Uma página 404 personalizada é exibida quando os usuários solicitam caminhos de URL que não correspondem a nenhum arquivo ou regra no seu app publicado. Para adicionar uma página 404 personalizada, crie o conteúdo da página em um arquivo chamado 404.html no diretório raiz do seu Replit App. Quando os usuários tentam acessar um caminho de URL que não existe, eles veem o HTML renderizado da página 404 personalizada.

Definir reescritas de caminho de URL

Você pode definir reescritas de URL para alterar o caminho de URL de uma requisição antes que seu Replit App a processe. A URL original permanece visível no navegador, mas o servidor carrega o recurso definido na regra de reescrita. Por exemplo, você pode especificar que todas as requisições iniciadas com /app carreguem o conteúdo do arquivo /app/index.html. Para criar esta entrada, adicione o seguinte ao arquivo .replit no diretório raiz do seu Replit App:
[[deployment.rewrites]]
from = "/app/*"
to = "/app/index.html"
  • from: Padrão de caminho de URL que corresponde aos recursos solicitados
  • to: Caminho reescrito, que corresponde a um arquivo no seu Static Deployment.
Você pode adicionar várias entradas deployment.rewrites ao arquivo .replit. O servidor interpreta as entradas na ordem listada e ignora duplicatas. Para aplicar as atualizações de configuração, você deve republicar seu Replit App. As seções a seguir descrevem as restrições das regras de reescrita de URL.

Correspondência de caminho

As seguintes restrições se aplicam aos parâmetros from e to nas regras de reescrita:
  • As correspondências devem ser exatas, a menos que um * esteja presente
  • Um * corresponde ao restante de um caminho
  • Um * só é válido no final do caminho
  • Ao incluir * no parâmetro from, você pode incluí-lo no parâmetro to para representar a seção correspondente do caminho
Por exemplo, se o seu arquivo .replit contiver a seguinte reescrita:
[[deployment.rewrites]]
from = "/v1/*"
to = "/v2/*"
Quando um usuário visita o caminho /v1/about-us.html, a reescrita serve o arquivo localizado em /v2/about-us.html.

Sombreamento

O sombreamento ocorre quando uma reescrita corresponde a um caminho de URL que também corresponde a um arquivo no seu Static Deployment. Quando isso ocorre, o servidor de nuvem ignora a reescrita e serve o arquivo diretamente. Por exemplo, suponha que seu app publicado contenha os seguintes arquivos:
  • index.html
  • about.html
O arquivo .replit contém a seguinte reescrita:
[[deployment.rewrites]]
from = "/*"
to = "/index.html"
Quando um usuário visita /register.html, o servidor reescreve a requisição para /index.html e serve esse arquivo. No entanto, se um usuário visitar /about.html, o servidor ignora a reescrita e serve o arquivo about.html, pois ele existe no seu Static Deployment.

Restrições de domínio

As reescritas funcionam apenas para requisições ao domínio principal do seu Static Deployment e só podem redirecionar para arquivos dentro do seu Static Deployment.