--- title: "Documentação do Django" version: 6.0 locale: pt-br source: https://docs.djangoproject.com/pt-br/6.0/ canonical: https://djangodocs.dev/pt-br/6.0/ --- # 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! - **From scratch:** [Overview](/pt-br/6.0/intro/overview/) | [Installation](/pt-br/6.0/intro/install/) - **Tutorial:** [Part 1: Requests and responses](/pt-br/6.0/intro/tutorial01/) | [Part 2: Models and the admin site](/pt-br/6.0/intro/tutorial02/) | [Part 3: Views and templates](/pt-br/6.0/intro/tutorial03/) | [Part 4: Forms and generic views](/pt-br/6.0/intro/tutorial04/) | [Part 5: Testing](/pt-br/6.0/intro/tutorial05/) | [Part 6: Static files](/pt-br/6.0/intro/tutorial06/) | [Part 7: Customizing the admin site](/pt-br/6.0/intro/tutorial07/) | [Part 8: Adding third-party packages](/pt-br/6.0/intro/tutorial08/) - **Advanced Tutorials:** [How to write reusable apps](/pt-br/6.0/intro/reusable-apps/) | [Writing your first contribution to Django](/pt-br/6.0/intro/contributing/) ## Obtendo ajuda Está com problemas? Nós gostaríamos de ajudar! - Try the [FAQ](/pt-br/6.0/faq/) – it’s got answers to many common questions. - Looking for specific information? Try the [Índice](/pt-br/6.0/genindex/), [Índice do Módulo](/pt-br/6.0/py-modindex/) or the [detailed table of contents](/pt-br/6.0/contents/). - Not found anything? See [FAQ: Obtendo ajuda](/pt-br/6.0/faq/help/) for information on getting support and asking questions to the community. - 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/6.0/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/6.0/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/6.0/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/6.0/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:** [Introduction to models](/pt-br/6.0/topics/db/models/) | [Field types](/pt-br/6.0/ref/models/fields/) | [Indexes](/pt-br/6.0/ref/models/indexes/) | [Meta options](/pt-br/6.0/ref/models/options/) | [Model class](/pt-br/6.0/ref/models/class/) - **QuerySets:** [Making queries](/pt-br/6.0/topics/db/queries/) | [QuerySet method reference](/pt-br/6.0/ref/models/querysets/) | [Lookup expressions](/pt-br/6.0/ref/models/lookups/) - **Model instances:** [Instance methods](/pt-br/6.0/ref/models/instances/) | [Accessing related objects](/pt-br/6.0/ref/models/relations/) - **Migrations:** [Introduction to Migrations](/pt-br/6.0/topics/migrations/) | [Operations reference](/pt-br/6.0/ref/migration-operations/) | [SchemaEditor](/pt-br/6.0/ref/schema-editor/) | [Writing migrations](/pt-br/6.0/howto/writing-migrations/) - **Advanced:** [Managers](/pt-br/6.0/topics/db/managers/) | [Raw SQL](/pt-br/6.0/topics/db/sql/) | [Transactions](/pt-br/6.0/topics/db/transactions/) | [Aggregation](/pt-br/6.0/topics/db/aggregation/) | [Search](/pt-br/6.0/topics/db/search/) | [Custom fields](/pt-br/6.0/howto/custom-model-fields/) | [Multiple databases](/pt-br/6.0/topics/db/multi-db/) | [Custom lookups](/pt-br/6.0/howto/custom-lookups/) | [Query Expressions](/pt-br/6.0/ref/models/expressions/) | [Conditional Expressions](/pt-br/6.0/ref/models/conditional-expressions/) | [Database Functions](/pt-br/6.0/ref/models/database-functions/) - **Other:** [Supported databases](/pt-br/6.0/ref/databases/) | [Legacy databases](/pt-br/6.0/howto/legacy-databases/) | [Providing initial data](/pt-br/6.0/howto/initial-data/) | [Optimize database access](/pt-br/6.0/topics/db/optimization/) | [PostgreSQL specific features](/pt-br/6.0/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: - **The basics:** [URLconfs](/pt-br/6.0/topics/http/urls/) | [View functions](/pt-br/6.0/topics/http/views/) | [Shortcuts](/pt-br/6.0/topics/http/shortcuts/) | [Decorators](/pt-br/6.0/topics/http/decorators/) | [Asynchronous Support](/pt-br/6.0/topics/async/) - **Reference:** [Built-in Views](/pt-br/6.0/ref/views/) | [Request/response objects](/pt-br/6.0/ref/request-response/) | [TemplateResponse objects](/pt-br/6.0/ref/template-response/) - **File uploads:** [Overview](/pt-br/6.0/topics/http/file-uploads/) | [File objects](/pt-br/6.0/ref/files/file/) | [Storage API](/pt-br/6.0/ref/files/storage/) | [Managing files](/pt-br/6.0/topics/files/) | [Custom storage](/pt-br/6.0/howto/custom-file-storage/) - **Class-based views:** [Overview](/pt-br/6.0/topics/class-based-views/) | [Built-in display views](/pt-br/6.0/topics/class-based-views/generic-display/) | [Built-in editing views](/pt-br/6.0/topics/class-based-views/generic-editing/) | [Using mixins](/pt-br/6.0/topics/class-based-views/mixins/) | [API reference](/pt-br/6.0/ref/class-based-views/) | [Flattened index](/pt-br/6.0/ref/class-based-views/flattened-index/) - **Advanced:** [Generating CSV](/pt-br/6.0/howto/outputting-csv/) | [Generating PDF](/pt-br/6.0/howto/outputting-pdf/) - **Middleware:** [Overview](/pt-br/6.0/topics/http/middleware/) | [Built-in middleware classes](/pt-br/6.0/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: - **The basics:** [Overview](/pt-br/6.0/topics/templates/) - **For designers:** [Language overview](/pt-br/6.0/ref/templates/language/) | [Built-in tags and filters](/pt-br/6.0/ref/templates/builtins/) | [Humanization](/pt-br/6.0/ref/contrib/humanize/) - **For programmers:** [Template API](/pt-br/6.0/ref/templates/api/) | [Custom tags and filters](/pt-br/6.0/howto/custom-template-tags/) | [Custom template backend](/pt-br/6.0/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. - **The basics:** [Overview](/pt-br/6.0/topics/forms/) | [Form API](/pt-br/6.0/ref/forms/api/) | [Built-in fields](/pt-br/6.0/ref/forms/fields/) | [Built-in widgets](/pt-br/6.0/ref/forms/widgets/) - **Advanced:** [Forms for models](/pt-br/6.0/topics/forms/modelforms/) | [Integrating media](/pt-br/6.0/topics/forms/media/) | [Formsets](/pt-br/6.0/topics/forms/formsets/) | [Customizing validation](/pt-br/6.0/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: - **Settings:** [Overview](/pt-br/6.0/topics/settings/) | [Full list of settings](/pt-br/6.0/ref/settings/) - **Applications:** [Overview](/pt-br/6.0/ref/applications/) - **Exceptions:** [Overview](/pt-br/6.0/ref/exceptions/) - **django-admin and manage.py:** [Overview](/pt-br/6.0/ref/django-admin/) | [Adding custom commands](/pt-br/6.0/howto/custom-management-commands/) - **Testing:** [Introduction](/pt-br/6.0/topics/testing/) | [Writing and running tests](/pt-br/6.0/topics/testing/overview/) | [Included testing tools](/pt-br/6.0/topics/testing/tools/) | [Advanced topics](/pt-br/6.0/topics/testing/advanced/) - **Deployment:** [Overview](/pt-br/6.0/howto/deployment/) | [WSGI servers](/pt-br/6.0/howto/deployment/wsgi/) | [ASGI servers](/pt-br/6.0/howto/deployment/asgi/) | [Deploying static files](/pt-br/6.0/howto/static-files/deployment/) | [Tracking code errors by email](/pt-br/6.0/howto/error-reporting/) | [Deployment checklist](/pt-br/6.0/howto/deployment/checklist/) ## O Admin Encontre tudo o que você precisa para conhecer sobre a interface automatizada de administração, uma das funcionalidades mais popular do Django: - [Admin site](/pt-br/6.0/ref/contrib/admin/) - [Admin actions](/pt-br/6.0/ref/contrib/admin/actions/) - [Admin documentation generator](/pt-br/6.0/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: - [Security overview](/pt-br/6.0/topics/security/) - [Disclosed security issues in Django](/pt-br/6.0/releases/security/) - [Clickjacking protection](/pt-br/6.0/ref/clickjacking/) - [Cross Site Request Forgery protection](/pt-br/6.0/ref/csrf/) - [Cryptographic signing](/pt-br/6.0/topics/signing/) - [Middleware de segurança](/pt-br/6.0/ref/middleware/#security-middleware) - [Content Security Policy](/pt-br/6.0/ref/csp/) ## 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: - [Overview](/pt-br/6.0/topics/i18n/) | [Internationalization](/pt-br/6.0/topics/i18n/translation/) | [Localization](/pt-br/6.0/topics/i18n/translation/#how-to-create-language-files) | [Localized web UI formatting and form input](/pt-br/6.0/topics/i18n/formatting/) - [Fusos horários](/pt-br/6.0/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. - [Performance and optimization overview](/pt-br/6.0/topics/performance/) ## Framework geográfico [GeoDjango](/pt-br/6.0/ref/contrib/gis/) intends to be a world-class geographic web framework. Its goal is to make it as easy as possible to build GIS web applications and harness the power of spatially enabled data. ## Ferramentas comuns de aplicação web O Django oferece várias ferramentas comumente necessárias no desenvolvimento de aplicações web: - **Authentication:** [Overview](/pt-br/6.0/topics/auth/) | [Using the authentication system](/pt-br/6.0/topics/auth/default/) | [Password management](/pt-br/6.0/topics/auth/passwords/) | [Customizing authentication](/pt-br/6.0/topics/auth/customizing/) | [API Reference](/pt-br/6.0/ref/contrib/auth/) - [Caching](/pt-br/6.0/topics/cache/) - [Logging](/pt-br/6.0/topics/logging/) - [Tasks framework](/pt-br/6.0/topics/tasks/) - [Sending emails](/pt-br/6.0/topics/email/) - [Syndication feeds (RSS/Atom)](/pt-br/6.0/ref/contrib/syndication/) - [Pagination](/pt-br/6.0/topics/pagination/) - [Messages framework](/pt-br/6.0/ref/contrib/messages/) - [Serialization](/pt-br/6.0/topics/serialization/) - [Sessions](/pt-br/6.0/topics/http/sessions/) - [Sitemaps](/pt-br/6.0/ref/contrib/sitemaps/) - [Static files management](/pt-br/6.0/ref/contrib/staticfiles/) - [Data validation](/pt-br/6.0/ref/validators/) ## Outras funcionalidades Saiba mais sobre algumas outras funcionalidades do núcleo do Django framework: - [Conditional content processing](/pt-br/6.0/topics/conditional-view-processing/) - [Content types and generic relations](/pt-br/6.0/ref/contrib/contenttypes/) - [Flatpages](/pt-br/6.0/ref/contrib/flatpages/) - [Redirects](/pt-br/6.0/ref/contrib/redirects/) - [Signals](/pt-br/6.0/topics/signals/) - [System check framework](/pt-br/6.0/topics/checks/) - [The sites framework](/pt-br/6.0/ref/contrib/sites/) - [Unicode in Django](/pt-br/6.0/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: - **Community:** [Contributing to Django](/pt-br/6.0/internals/contributing/) | [The release process](/pt-br/6.0/internals/release-process/) | [Team organization](/pt-br/6.0/internals/organization/) | [The Django source code repository](/pt-br/6.0/internals/git/) | [Security policies](/pt-br/6.0/internals/security/) | [Mailing lists and Forum](/pt-br/6.0/internals/mailing-lists/) - **Design philosophies:** [Overview](/pt-br/6.0/misc/design-philosophies/) - **Documentation:** [About this documentation](/pt-br/6.0/internals/contributing/writing-documentation/) - **Third-party distributions:** [Overview](/pt-br/6.0/misc/distributions/) - **Django over time:** [API stability](/pt-br/6.0/misc/api-stability/) | [Release notes and upgrading instructions](/pt-br/6.0/releases/) | [Deprecation Timeline](/pt-br/6.0/internals/deprecation/)