..
.. META INFORMATION OF TRANSLATION
..
..   $TranslationStatus: Done, waiting for revision. $
..   $OriginalRevision: 10838 $
..   $TranslationAuthors: Walter Cruz $
..
.. INFO OF THIS FILE (DO NOT EDIT! UPDATED BY SUBVERSION)
..
..   $HeadURL: http://django-l10n-portuguese.googlecode.com/svn/branches/docs-1.0.X/howto/deployment/modwsgi.txt $
..   $LastChangedRevision: 307 $
..   $LastChangedBy: robsonmwoc $
..   $LastChangedDate: 2009-06-30 22:38:41 -0300 (Tue, 30 Jun 2009) $
..


.. _howto-deployment-modwsgi:

==========================================
Como usar o Django com o Apache e mod_wsgi
==========================================

A implantação do Django com Apache_ e `mod_wsgi`_ é a forma recomendada de ter o
Django funcionando em produção.

.. _Apache: http://httpd.apache.org/
.. _mod_wsgi: http://code.google.com/p/modwsgi/

O mod_wsgi é um módulo do Apache que pode ser usado para hospedar qualquer aplicação Python
que suporte a `Interface WSGI do Python`_, incluindo o Django. O Django irá funcionar
com qualquer versão do Apache que suporte o mod_wsgi.

.. _interface wsgi do python: http://www.python.org/dev/peps/pep-0333/

A `documentação oficial do mod_wsgi`_ é fantástica; é sua fonte para todos
os detalhes sobre como usar o mod_wsgi. você provavalmente irá querer iniciar com a
`documentação de instalação e configuração`_.

.. _documentação oficial do mod_wsgi: http://code.google.com/p/modwsgi/
.. _documentação de instalação e configuração: http://code.google.com/p/modwsgi/wiki/InstallationInstructions

Configuração Básica
===================

Uma vez que você tenha o mod_wsgi instalado e ativado, edite o seu arquivo ``httpd.conf``
e adicione::

    WSGIScriptAlias / /path/to/mysite/apache/django.wsgi

A primeira parte acima é a url na qual você estará servindo sua aplicação (``/``
indica a url raiz), e a segunda parte é a localização de um "arquivo WSGI" -- veja
abaixo -- no seu sistema, normalmente dentro do seu projeto. Isso diz ao Apache
para servir quaisquer requisições abaixo de dada URL usando a aplicação WSGI definida por aquele arquivo.

Em seguida, vamos efetivamente criar essa aplicação WSGI, então crie o arquivo
mencionado na segunda parte da linha ``WSGIScriptAlias`` e adicione::

    import os
    import sys

    os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'

    import django.core.handlers.wsgi
    application = django.core.handlers.wsgi.WSGIHandler()

Se o seu projeto não está no ``PYTHONPATH`` padrão você pode adicionar::

    sys.path.append('/usr/local/django')

logo abaixo das linhas de ``import`` para colocar o seu projeto no path. Lembre-se de
substituir o 'mysite.settings' como seu arquivo de configurações correto.

Veja a :ref:`Documentação do Apache/mod_python<howto-deployment-modpython>` para
informações de como servir mídia estática, e a `documentação do mod_wsgi`_ para uma
explicação de outras diretivas e opções de configuração que você pode usar.

Detalhes
========

Para maiores detalhes, veja a `documentação do mod_wsgi`_, que explica os itens acima em
maior detalhamento, e lhe dá todas as possibilidades de opções que você tem
ao fazer uma implantação no mod_wsgi.

.. _documentação do mod_wsgi: http://code.google.com/p/modwsgi/wiki/IntegrationWithDjango