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 aborda as seguintes configurações no nível do servidor web:

​
Adicionar cabeçalhos de resposta

Cabeçalhos de resposta personalizados permitem que você adicione instruções de cabeçalho HTTP a requisições que correspondam 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 essa 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 múltiplas 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 tentarem acessar um caminho de URL que não existe, eles verão o HTML renderizado da página 404 personalizada.

​
Definir rewrites de caminho de URL

Você pode definir rewrites 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 rewrite. Por exemplo, você pode especificar que todas as requisições que começam com /app carregam o conteúdo do arquivo /app/index.html. Para criar essa 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 Deployment Estático.
Você pode adicionar múltiplas 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 rewrite de URL.

​
Correspondência de caminho

As seguintes restrições se aplicam aos parâmetros from e to nas regras de rewrite:
  • As correspondências devem ser exatas, a menos que um * esteja presente
  • Um * corresponde ao restante de um caminho
  • Um * é válido apenas 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 arquivo .replit contiver o seguinte rewrite: 
[[deployment.rewrites]]
from = "/v1/*"
to = "/v2/*"
Quando um usuário visitar o caminho /v1/about-us.html, o rewrite servirá o arquivo localizado em /v2/about-us.html.

​
Shadowing

Shadowing ocorre quando um rewrite corresponde a um caminho de URL que também corresponde a um arquivo no seu Deployment Estático. Quando isso ocorre, o servidor na nuvem ignora o rewrite 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 o seguinte rewrite: 
[[deployment.rewrites]]
from = "/*"
to = "/index.html"
Quando um usuário visitar /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 o rewrite e serve o arquivo about.html já que ele existe no seu Deployment Estático.

​
Restrições de domínio

Rewrites funcionam apenas para requisições ao domínio principal do seu Deployment Estático e só podem redirecionar para arquivos dentro do seu Deployment Estático.