Commit 40f24b46 authored by Russell Keith-Magee's avatar Russell Keith-Magee
Browse files

[1.0.X] Fixed #10426 -- Added note on language variables required for Apache... 

[1.0.X] Fixed #10426 -- Added note on language variables required for Apache to survive non-ASCII file uploads. Thanks to daybreaker for the report, and david for the draft text.

Merge of r11170 from trunk.


git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.0.X@11172 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent c05f4d5a

docs/howto/deployment/modpython.txt

+23 −2
Original line number Diff line number Diff line
@@ -378,3 +378,24 @@ as necessary. 
.. _Expat Causing Apache Crash: http://www.dscpl.com.au/articles/modpython-006.html

.. _mod_python FAQ entry: http://modpython.org/FAQ/faqw.py?req=show&file=faq02.013.htp

.. _Getting mod_python Working: http://www.dscpl.com.au/articles/modpython-001.html



If you get a UnicodeEncodeError

===============================



If you're taking advantage of the internationalization features of Django (see

:ref:`topics-i18n`) and you intend to allow users to upload files, you must

ensure that the environment used to start Apache is configured to accept

non-ASCII file names. If your environment is not correctly configured, you

will trigger ``UnicodeEncodeError`` exceptions when calling functions like

``os.path()`` on filenames that contain non-ASCII characters.



To avoid these problems, the environment used to start Apache should contain

settings analogous to the following::



    export LANG='en_US.UTF-8'

    export LC_ALL='en_US.UTF-8'



Consult the documentation for your operating system for the appropriate syntax

and location to put these configuration items; ``/etc/apache2/envvars`` is a

common location on Unix platforms. Once you have added these statements

to your environment, restart Apache.