[4.0.x] Improved docs regarding UTF-8 support with Apache and mod_wsgi.

Backport of bf4be3711a from main
This commit is contained in:
Nick Frazier 2021-10-05 08:42:45 -04:00 committed by Mariusz Felisiak
parent f2a59630f4
commit fe97f8bb62
2 changed files with 12 additions and 6 deletions

View file

@ -83,15 +83,21 @@ should put in this file, and what else you can add to it.
.. admonition:: Fixing ``UnicodeEncodeError`` for file uploads
If you get a ``UnicodeEncodeError`` when uploading files with file names
that contain non-ASCII characters, make sure Apache is configured to accept
non-ASCII file names::
If you get a ``UnicodeEncodeError`` when uploading or writing files with
file names or content that contains non-ASCII characters, make sure Apache
is configured to support UTF-8 encoding::
export LANG='en_US.UTF-8'
export LC_ALL='en_US.UTF-8'
A common location to put this configuration is ``/etc/apache2/envvars``.
Alternatively, if you are :ref:`using mod_wsgi daemon mode<daemon-mode>`
you can add ``lang`` and ``locale`` options to the ``WSGIDaemonProcess``
directive::
WSGIDaemonProcess example.com lang='en_US.UTF-8' locale='en_US.UTF-8'
See the :ref:`unicode-files` section of the Unicode reference guide for
details.