Este documento lhe dirá como instalar e rodar o Django.
\nDjango is a Python web framework. See Qual versão do Python eu posso usar com Django? for\ndetails.
\nObtenha a última versão do Python em https://www.python.org/downloads/ ou no gerenciador de pacotes do seu sistema operacional.
\n\nmod_wsgiLink para este cabeçalho#Se você quer apenas experimentar o Django, passe a frente para a próxima seção; o Django inclui um servidor Web leve que você pode usar para testes, aí você não precisa configurar o Apache anté que esteja pronto para implantar o Django em produção.
\nIf you want to use Django on a production site, use Apache with\nmod_wsgi. mod_wsgi operates in one of two modes: embedded\nmode or daemon mode. In embedded mode, mod_wsgi is similar to\nmod_perl – it embeds Python within Apache and loads Python code into\nmemory when the server starts. Code stays in memory throughout the\nlife of an Apache process, which leads to significant performance\ngains over other server arrangements. In daemon mode, mod_wsgi spawns\nan independent daemon process that handles requests. The daemon\nprocess can run as a different user than the web server, possibly\nleading to improved security. The daemon process can be restarted\nwithout restarting the entire Apache web server, possibly making\nrefreshing your codebase more seamless. Consult the mod_wsgi\ndocumentation to determine which mode is right for your setup. Make\nsure you have Apache installed with the mod_wsgi module activated.\nDjango will work with any version of Apache that supports mod_wsgi.
\nVeja Como usar o Django com mod_wsgi para informações de como configurar o mod_wsgi depois de tê-lo instalado.
\nSe não pode usar o mod_wsgi por alguma razão, não se preocupe: o Django suporta muitas outras opções para implantação. Uma é uWSGI; ele trabalha bem com o nginx. Adina, o Django segue a especificação (PEP 3333) WSGI, o qual lhe permiti rodar em uma variedade de plataformas de servidores.
\nIf you plan to use Django’s database API functionality, you’ll need to make\nsure a database server is running. Django supports many different database\nservers and is officially supported with PostgreSQL, MariaDB, MySQL, Oracle\nand SQLite.
\nIf you are developing a small project or something you don’t plan to deploy in\na production environment, SQLite is generally the best option as it doesn’t\nrequire running a separate server. However, SQLite has many differences from\nother databases, so if you are working on something substantial, it’s\nrecommended to develop with the same database that you plan on using in\nproduction.
\nAlém dos bancos de dados oficialmente suportados, existem “backends” fornecidos por terceiros que permitem que você use outros bancos de dados com o Django.
\nAlém do “backend” do banco de dados, você precisa assegurar que seus “bindings” para Python para o banco de dados estão instalados.
\nSe você estiver usando o PostgreSQL, você precisa do pacote psycopg2. Veja as Notas sobre PostgreSQL para maiores detalhes.
If you’re using MySQL or MariaDB, you’ll need a DB API driver like mysqlclient. See notes for the MySQL\nbackend for details.
Se você estiver usando SQLite você talvez queira ler as Notas para o Backend do SQLite.
Se você estiver usando Oracle, você irá precisar de uma cópia do cx_Oracle, mas por favor leia as notas para o Backend do Oracle para detalhes sobre versões suportadas para ambos o Oracle e o cx_Oracle.
Se você estiver usando um “backend” não oficial de terceiros, por favor consulte a documentação fornecida para qualquer requerimento adicional.
If you plan to use Django’s manage.py migrate command to automatically\ncreate database tables for your models (after first installing Django and\ncreating a project), you’ll need to ensure that Django has permission to create\nand alter tables in the database you’re using; if you plan to manually create\nthe tables, you can grant Django SELECT, INSERT, UPDATE and\nDELETE permissions. After creating a database user with these permissions,\nyou’ll specify the details in your project’s settings file, see\nDATABASES for details.
Se você está usando o framework de testes do Django para testar consultas no banco de dados, o Django irá precisar de permissão para criar o banco de dados de teste.
\nAs instruções de instalação são um pouco diferentes dependendo de se você está instalando um pacote de uma distribuição específica, fazendo o download da última versão oficial, ou pegando a última versão em desenvolvimento.
\npipLink para este cabeçalho#Este é o modo recomendável de instalar o Django.
\nInstale o pip. A maneira mais fácil é usar o standalone pip installer. Se sua distribuição já tem o pip instalado, você talvez precisa atualizá-lo se estiver desatualizado, você saberá porque a instalação não irá funcionar.
Take a look at venv. This tool provides\nisolated Python environments, which are more practical than installing\npackages systemwide. It also allows installing packages without\nadministrator privileges. The contributing tutorial walks through how to create a virtual environment.
After you’ve created and activated a virtual environment, enter the command:
\nLinux / macOS
$ python -m pip install Django\nWindows
...\\> py -m pip install Django\nCheck the distribution specific notes to see if\nyour platform/distribution provides official Django packages/installers.\nDistribution-provided packages will typically allow for automatic installation\nof dependencies and supported upgrade paths; however, these packages will rarely\ncontain the latest release of Django.
\nSe você quiser ser capaz de ocasionalmenete atualizar o seu código Django com as últimas correções e melhorias, siga estas instruções:
\nAssegure-se que tenha instalado o Git e que você pode executar seus comandos no seu shell. (Digite git help no “prompt” do seu shell para testar.)
Pegue o pricipal ramo de desenvolvimento do Django como aqui:
\nLinux / macOS
$ git clone https://github.com/django/django.git\nWindows
...\\> git clone https://github.com/django/django.git\nIsso irá criar um diretório django no seu diretório corrente.
Make sure that the Python interpreter can load Django’s code. The most\nconvenient way to do this is to use a virtual environment and pip. The\ncontributing tutorial walks through how to\ncreate a virtual environment.
After setting up and activating the virtual environment, run the following\ncommand:
\nLinux / macOS
$ python -m pip install -e django/\nWindows
...\\> py -m pip install -e django\\\nIsso fará com que o código do Django seja passível de importação, e fará co que o comando utilitário django-admin esteja disponível. Em outras palavras, você está pronto.
When you want to update your copy of the Django source code, run the command\ngit pull from within the django directory. When you do this, Git will\ndownload any changes.