--- title: "Documentação do Django" version: 4.1 locale: pt-br source: https://docs.djangoproject.com/pt-br/4.1/ canonical: https://djangodocs.dev/pt-br/4.1/ --- # Documentação do Django **Tudo o que você precisa saber sobre Django.** ## Primeiros passos Você é novo no Django ou na programação? Este é o lugar para começar! - **Do início:** [Visão geral](/pt-br/4.1/intro/overview/) | [Instalação](/pt-br/4.1/intro/install/) - **Tutorial:** [Parte 1: Requisições e respostas](/pt-br/4.1/intro/tutorial01/) | [Parte 2: Modelos e o site Admin](/pt-br/4.1/intro/tutorial02/) | [Parte 3: Views e templates](/pt-br/4.1/intro/tutorial03/) | [Parte 4: Forms e views genéricas](/pt-br/4.1/intro/tutorial04/) | [Parte 5: Testando](/pt-br/4.1/intro/tutorial05/) | [Part e 6: Arquivos estáticos](/pt-br/4.1/intro/tutorial06/) | [Parte 7: Personalizando o site admin](/pt-br/4.1/intro/tutorial07/) - **Tutoriais avançados:** [Como escrever aplicações reutilizáveis](/pt-br/4.1/intro/reusable-apps/) | [Escrevendo seu primeiro patch para o Django](/pt-br/4.1/intro/contributing/) ## Obtendo ajuda Está com problemas? Nós gostaríamos de ajudar! - Tente o [FAQ](/pt-br/4.1/faq/) – para obter respostas para muitas perguntas comuns. - Procurando por alguma informação específica? Tente o [Índice](/pt-br/4.1/genindex/), [Índice do Módulo](/pt-br/4.1/py-modindex/) ou the [tabela detalhada de conteúdos](/pt-br/4.1/contents/). - Não encontrou nada ? Veja o [FAQ: Obtendo ajuda](/pt-br/4.1/faq/help/) para informações sobre como obter suporte e pergunte a comunidade. - Relate bugs do Django no nosso [ticket tracker](https://code.djangoproject.com/). ## Como a documentação é organizada Django tem uma grande quantidade de documentação. Uma visão geral de como ele é organizado vai te ajudar a saber aonde procurar para certas coisas: - [Tutoriais](/pt-br/4.1/intro/) conduzem você pela mão através de uma série de passos para criar uma aplicação web. Comece aqui se você é novo no Django ou no desenvolvimento de aplicações web. Veja também o “[Primeiros passos](#index-first-steps)”. - [Guia de tópicos](/pt-br/4.1/topics/) discute temas-chave e conceitos em um nível relativamente alto, fornece explicaçõesde modo de funcionamento e informações úteis. - [Guiaa de referências](/pt-br/4.1/ref/) contém referência técnica para APIs e outros aspectos do maquinário do Django. Eles descrevem como isso funciona e como usá-los, mas assume que você tem um entendimento básico dos conceitos chaves. - [Guias ‘How-to’](/pt-br/4.1/howto/) são receitas. Eles guiam você através de passos baseados na abordagem de problemas chave e casos de uso. Eles são mais avançados que os tutoriais e assumem que você já tem algum conhecimento de como o Django trabalha. ## A camada de modelo O Django fornece uma camada de abstração (os “modelos”) para estruturar e manipular os dados de sua aplicação web. Saiba mais sobre isso abaixo: - **Models:** [Introdução ao “Models”](/pt-br/4.1/topics/db/models/) | [Tipos de campos](/pt-br/4.1/ref/models/fields/) | [Índices](/pt-br/4.1/ref/models/indexes/) | [Opções da Meta](/pt-br/4.1/ref/models/options/) | [A classe Model](/pt-br/4.1/ref/models/class/) - **QuerySets:** [Fazendo consultas](/pt-br/4.1/topics/db/queries/) | [Referência do método QuerySet](/pt-br/4.1/ref/models/querysets/) | [Expressões de pesquisa](/pt-br/4.1/ref/models/lookups/) - **Instâncias de modelo:** [Métodos de instâncias](/pt-br/4.1/ref/models/instances/) | [Acessando objetos relacionados](/pt-br/4.1/ref/models/relations/) - **Migração:** [Introdução a Migrações](/pt-br/4.1/topics/migrations/) | [Referência de operação](/pt-br/4.1/ref/migration-operations/) | [SchemaEditor](/pt-br/4.1/ref/schema-editor/) | [Escrevendo migrações](/pt-br/4.1/howto/writing-migrations/) - **Avançado:** [Managers](/pt-br/4.1/topics/db/managers/) | [Raw SQL](/pt-br/4.1/topics/db/sql/) | [Transações de dados](/pt-br/4.1/topics/db/transactions/) | [Agregação de dados](/pt-br/4.1/topics/db/aggregation/) | [Campos personalizados de modelo](/pt-br/4.1/howto/custom-model-fields/) | [Multiple os bancos de dados](/pt-br/4.1/topics/db/multi-db/) | [Pesquisa customizada](/pt-br/4.1/howto/custom-lookups/) | [Expressões de consulta](/pt-br/4.1/ref/models/expressions/) | [Expressões condicionais](/pt-br/4.1/ref/models/conditional-expressions/) | [Funções de base de dados](/pt-br/4.1/ref/models/database-functions/) - **Outros:** [Banco de dados suportados](/pt-br/4.1/ref/databases/) | [Bancos de dados legados](/pt-br/4.1/howto/legacy-databases/) | [Provendo dados iniciais](/pt-br/4.1/howto/initial-data/) | [Otimizando acesso ao banco de dados](/pt-br/4.1/topics/db/optimization/) | [Características específicas do PostgreSQL](/pt-br/4.1/ref/contrib/postgres/) ## A camada de visão Django tem o conceito de “views” para encapsular a lógica responsável pelo processamento de um request de um usuário e para retornar o response. Encontre tudo que você precisa saber sobre views através dos links abaixo: - **O básico:** [URLconfs](/pt-br/4.1/topics/http/urls/) | [Funções de view](/pt-br/4.1/topics/http/views/) | [Atalhos](/pt-br/4.1/topics/http/shortcuts/) | [Decorators](/pt-br/4.1/topics/http/decorators/) | [Suporte assíncrono](/pt-br/4.1/topics/async/) - **Referência:** [Views nativas](/pt-br/4.1/ref/views/) | [Objetos request/response](/pt-br/4.1/ref/request-response/) | [Objetos TemplateResponse](/pt-br/4.1/ref/template-response/) - **File uploads:** [Visão Geral](/pt-br/4.1/topics/http/file-uploads/) | [File objects](/pt-br/4.1/ref/files/file/) | [Storage API](/pt-br/4.1/ref/files/storage/) | [Managing files](/pt-br/4.1/topics/files/) | [Custom storage](/pt-br/4.1/howto/custom-file-storage/) - **Class-based views:** [Visão Geral](/pt-br/4.1/topics/class-based-views/) | [modo interno para views](/pt-br/4.1/topics/class-based-views/generic-display/) | [edição interna para views](/pt-br/4.1/topics/class-based-views/generic-editing/) | [Usando mixins](/pt-br/4.1/topics/class-based-views/mixins/) | [API referência](/pt-br/4.1/ref/class-based-views/) | [index plana](/pt-br/4.1/ref/class-based-views/flattened-index/) - **Avançado:** [Gerando CSV](/pt-br/4.1/howto/outputting-csv/) | [Gerando PDF](/pt-br/4.1/howto/outputting-pdf/) - **Middleware:** [Visão geral](/pt-br/4.1/topics/http/middleware/) | [Classes de Middleware embutidas](/pt-br/4.1/ref/middleware/) ## A camada de template A camada de template fornece uma sintaxe amigável para designers para o processamento de informações a serem apresentadas para o usuário. Aprenda como essa sintaxe pode ser usada por designers e como ela pode ser estendida por programadores: - **O basico:** [Visão geral](/pt-br/4.1/topics/templates/) - **Para designers:** [Visão geral da linguagem](/pt-br/4.1/ref/templates/language/) | [Tags e filtros incluídos](/pt-br/4.1/ref/templates/builtins/) | [Humanização](/pt-br/4.1/ref/contrib/humanize/) - **Para programadores:** [API de Template](/pt-br/4.1/ref/templates/api/) | [Tags e filtros personalizados](/pt-br/4.1/howto/custom-template-tags/) | [Backend de template personalizado](/pt-br/4.1/howto/custom-template-backend/) ## Formulários Django fornece um framework rico para facilitar a criação de formulários de a manipulacação de dados do formulário. - **O básico:** [Visão geral](/pt-br/4.1/topics/forms/) | [Formulário API](/pt-br/4.1/ref/forms/api/) | [Built-in fields](/pt-br/4.1/ref/forms/fields/) | [Widgets embutidos](/pt-br/4.1/ref/forms/widgets/) - **Avançado:** [Forms para models](/pt-br/4.1/topics/forms/modelforms/) | [integrando media](/pt-br/4.1/topics/forms/media/) | [Formsets](/pt-br/4.1/topics/forms/formsets/) | [Customizando a validação](/pt-br/4.1/ref/forms/validation/) ## O processo de desenvolvimento Aprenda sobre os vários componentes e ferramentas para ajudá-lo no desenvolvimento e teste de aplicações Django: - **Configurações:** Visão global | [Lista completa de configurações](/pt-br/4.1/ref/settings/) - **Aplicações:** [Visão geral](/pt-br/4.1/ref/applications/) - **Exceções:** [Visão global](/pt-br/4.1/ref/exceptions/) - **django-admin e manage.py:** [Visão geral](/pt-br/4.1/ref/django-admin/) | [Adicionando comandos personalizados](/pt-br/4.1/howto/custom-management-commands/) - **Testando:** [Introdução](/pt-br/4.1/topics/testing/) | [Escrevendo e rodando testes](/pt-br/4.1/topics/testing/overview/) | [Ferramentas de testes inclusas](/pt-br/4.1/topics/testing/tools/) | [Tópicos avançados](/pt-br/4.1/topics/testing/advanced/) - **Implantação:** [Visão Geral](/pt-br/4.1/howto/deployment/) | [Servidores WSGI](/pt-br/4.1/howto/deployment/wsgi/) | [Implantando arquivos estáticos](/pt-br/4.1/howto/static-files/deployment/) | [Reportando códigos de erros por e-mail](/pt-br/4.1/howto/error-reporting/) ## O Admin Encontre tudo o que você precisa para conhecer sobre a interface automatizada de administração, uma das funcionalidades mais popular do Django: - [Site Admin](/pt-br/4.1/ref/contrib/admin/) - [Ações do Admin](/pt-br/4.1/ref/contrib/admin/actions/) - [Gerador de documentação do Admin](/pt-br/4.1/ref/contrib/admin/admindocs/) ## Segurança A segurança é um tema de suma importância no desenvolvimento de aplicações web e o Django oferece múltiplas ferramentas e mecanismos de proteção: - [Visão geral sobre segurança](/pt-br/4.1/topics/security/) - [Questões de segurança divulgadas no Django](/pt-br/4.1/releases/security/) - [Proteção Clickjacking](/pt-br/4.1/ref/clickjacking/) - [Proteção contra Cross Site Request Forgery](/pt-br/4.1/ref/csrf/) - [Assinatura criptográfica](/pt-br/4.1/topics/signing/) - [Middleware de segurança](/pt-br/4.1/ref/middleware/#security-middleware) ## Internacionalização e localização Django oferece um robusto framework para internacionalização e localização para a auxiliá-lo no desenvolvimento de aplicações para vários idiomas e regiões do mundo: - [Visão geral](/pt-br/4.1/topics/i18n/) | [Internacionalização](/pt-br/4.1/topics/i18n/translation/) | [Localização](/pt-br/4.1/topics/i18n/translation/#how-to-create-language-files) | [Formato de localização da Web UI e entrada de formulário](/pt-br/4.1/topics/i18n/formatting/) - [Fusos horários](/pt-br/4.1/topics/i18n/timezones/) ## Performance e otimização Há uma variedade de técnicas e ferramentas que podem ajudar a fazer com que o seu código execute com mais eficiência - mais rápido e usando menos recursos do sistema. - [Visão geral do desempenho e otimização](/pt-br/4.1/topics/performance/) ## Framework geográfico [GeoDjango](/pt-br/4.1/ref/contrib/gis/) pretende ser um framework web geográfico de classe mundial. Seu objetivo é facilitar ao máximo a construção de aplicativos web GIS e aproveitar o poder dos dados habilitados espacialmente. ## Ferramentas comuns de aplicação web O Django oferece várias ferramentas comumente necessárias no desenvolvimento de aplicações web: - **Autenticação:** [Visão feral](/pt-br/4.1/topics/auth/) | [Usando o sistemas de autenticação](/pt-br/4.1/topics/auth/default/) | [gerenciamento de senhas](/pt-br/4.1/topics/auth/passwords/) | [Autenticação personalizada](/pt-br/4.1/topics/auth/customizing/) | [API de referencia](/pt-br/4.1/ref/contrib/auth/) - [Cacheamento](/pt-br/4.1/topics/cache/) - [Logging](/pt-br/4.1/topics/logging/) - [Enviando emails](/pt-br/4.1/topics/email/) - [Feeds (RSS/Atom)](/pt-br/4.1/ref/contrib/syndication/) - [Paginação](/pt-br/4.1/topics/pagination/) - [Framework de mensagens](/pt-br/4.1/ref/contrib/messages/) - [Serialização](/pt-br/4.1/topics/serialization/) - [Sessões](/pt-br/4.1/topics/http/sessions/) - [Sitemaps](/pt-br/4.1/ref/contrib/sitemaps/) - [Gerenciamento de arquivos estáticos](/pt-br/4.1/ref/contrib/staticfiles/) - [Validação de dados](/pt-br/4.1/ref/validators/) ## Outras funcionalidades Saiba mais sobre algumas outras funcionalidades do núcleo do Django framework: - [Processamento condicional de conteúdo](/pt-br/4.1/topics/conditional-view-processing/) - [Tipos de conteúdos e relações genéricas](/pt-br/4.1/ref/contrib/contenttypes/) - [Flatpages](/pt-br/4.1/ref/contrib/flatpages/) - [Redirecionamentos](/pt-br/4.1/ref/contrib/redirects/) - [Signals](/pt-br/4.1/topics/signals/) - [Framework de verificação do sistema](/pt-br/4.1/topics/checks/) - [O framework Sites](/pt-br/4.1/ref/contrib/sites/) - [Unicode no Django](/pt-br/4.1/ref/unicode/) ## O projeto de código-aberto Django Saiba mais sobre o processo de desenvolvimento do próprio Django e como você pode contribuir: - **Comunidade:** [Como participar](/pt-br/4.1/internals/contributing/) | [O processo de publicação](/pt-br/4.1/internals/release-process/) | [Organização do time](/pt-br/4.1/internals/organization/) | [O repositório do código fonte do Django](/pt-br/4.1/internals/git/) | [Políticas de segurança](/pt-br/4.1/internals/security/) | [Listas de e-mails](/pt-br/4.1/internals/mailing-lists/) - **Filosofias de design:** [Visão geral](/pt-br/4.1/misc/design-philosophies/) - **Documentação:** [Sobre esta documentação](/pt-br/4.1/internals/contributing/writing-documentation/) - **Distribuição de terceiros:** [Visão geral](/pt-br/4.1/misc/distributions/) - **Django ao longo do tempo:** [Estabilidade da AP](/pt-br/4.1/misc/api-stability/) | [Notas de lançamento e instruções de atualização](/pt-br/4.1/releases/) | [Cronograma de depreciação](/pt-br/4.1/internals/deprecation/)