Como a WSGI conecta servidor e aplicação
A WSGI (Web Server Gateway Interface) é uma interface padronizada para a comunicação entre servidores web e aplicações Python. Ela define como o servidor chama a aplicação e como recebe o status, os cabeçalhos e o corpo da resposta.
A aplicação recebe dois argumentos: environ, um dicionário com informações da requisição, e start_response, uma função fornecida pelo servidor. A aplicação chama essa função para informar o status e os cabeçalhos, depois retorna um iterável com os bytes do corpo.
Uma resposta de texto pela interface
Neste exemplo didático, a aplicação devolve a mesma mensagem para qualquer requisição:
def application(environ, start_response): start_response("200 OK", [("Content-Type", "text/plain")]) return [b"OK"]Ao chamar application com os dois argumentos previstos, um servidor WSGI recebe o status 200 OK e um corpo de dois bytes que forma o texto OK. A lista contém bytes, como exige a interface no Python 3. O exemplo não examina o caminho recebido em environ, por isso não diferencia páginas.
Você pode manter essa forma de comunicação ao trocar de servidor compatível, mas ainda precisa conferir a configuração de execução. A quantidade de processos ou threads continua sendo uma escolha do servidor, sem garantia de desempenho igual entre implementações.
Dúvidas frequentes
Perguntas frequentes sobre WSGI
- WSGI é um servidor web?
- A WSGI é uma especificação de interface. Um servidor compatível implementa essa interface para chamar a aplicação Python.
- Posso retornar uma string como corpo da resposta?
- No Python 3, a aplicação retorna um iterável de objetos bytes. Um texto deve ser codificado, por exemplo em UTF-8, para compor esse retorno.
- A WSGI determina quantas requisições são atendidas ao mesmo tempo?
- A concorrência depende do servidor e de sua configuração de processos ou threads. A compatibilidade WSGI não estabelece uma capacidade de atendimento.
Para continuar
Recursos relacionados
Documentação
PEP 3333: interface WSGI para aplicações Python
Especificação da chamada à aplicação, dos tipos aceitos e da produção da resposta.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão ao vivo para investigar a integração da aplicação Python com o servidor, com você no editor e no terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar uma aplicação Python, você pode conferir os argumentos recebidos pela função WSGI e os bytes retornados na resposta.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.