Следующий сценарий mprocess.py выведет в браузере страницу со словами Hello, world!:
Листинг
from mod_python import apache
def handler(req):
req.content_type = «text/html»
req.send_http_header()
req.write("""
Hello, world! Hello, world!""")
return apache.OK
Отличия сценария–обработчика от CGI–сценария:
Сценарий–обработчик не запускается при каждом HTTP–запросе: он уже находится в памяти, и из него вызываются необходимые функции–обработчики (в приведенном примере такая функция всего одна — handler()). Каждый процесс–потомок web–сервера может иметь свою копию сценария и интерпретатора Python.
Как следствие п.1 различные HTTP–запросы делят одни и те же глобальные переменные. Например, таким образом можно инициализировать соединение с базой данных и применять его во всех запросах (хотя в некоторых случаях потребуются блокировки, исключающие одновременное использование соединения разными потоками (нитями) управления).
Обработчик задействуется при обращении к любому «файлу» с расширением py, тогда как CGI–сценарий обычно запускается при обращении по конкретному имени.
В сценарии–обработчике нельзя рассчитывать на то, что он увидит модули, расположенные в том же каталоге. Возможно, придется добавить некоторые каталоги в sys.path.
Текущий рабочий каталог (его можно узнать с помощью функции os.getcwd()) также не находится в одном каталоге с обработчиком.
#! — строка в первой строке сценария не определяет версию интерпретатора Python. Работает версия, для которой был скомпилирован mod_python.
Все необходимые параметры передаются в обработчик в виде Request–объекта. Возвращаемые значения также передаются через этот объект.
Web–сервер замечает, что сценарий–обработчик изменился, но не заметит изменений в импортируемых в него модулях. Команда touch mprocess.py обновит дату изменения файла сценария.
Отображение os.environ в обработчике может быть обрезанным. Кроме того, вызываемые из сценария–обработчика другие программы его не наследуют, как это происходит при работе с CGI–сценариями. Переменные можно получить другим путем: req.add_common_vars(); params = req.subprocess_env.
Так как сценарий–обработчик не является «одноразовым», как CGI–сценарий, из–за ошибок программирования (как самого сценария, так и других компонентов) могут возникать утечки памяти (программа не освобождает ставшую ненужной память). Следует установить значение параметра MaxRequestsPerChild (максимальное число запросов, обрабатываемое одним процессом–потомком) больше нуля.
Другой возможный обработчик — сценарий идентификации:
Листинг
def authenhandler(req):
password = req.get_basic_auth_pw()
user = req.connection.user
if user == «user1» and password == «secret»:
return apache.OK
else:
return apache.HTTP_UNAUTHORIZED
Эту функцию следует добавить в модуль mprocess.py, который был рассмотрен ранее. Кроме того, нужно дополнить конфигурацию, назначив обработчик для запросов идентификации (PythonAuthenHandler), а также обычные для Apache директивы AuthType, AuthName, require, определяющие способ авторизации:
Листинг
AddHandler python–program .py
PythonHandler mprocess
PythonAuthenHandler mprocess
AuthType Basic
AuthName «My page»
require valid–user
Разумеется, это — всего лишь пример. В реальности идентификация может быть устроена намного сложнее.
Другие возможные обработчики (по документации к mod_python можно уточнить, в какие моменты обработки запроса они вызываются):
Листинг
PythonPostReadRequestHandler
Обработка полученного запроса сразу после его получения.
Листинг
PythonTransHandler
Позволяет изменить URI запроса (в том числе имя виртуального сервера).
Листинг
PythonHeaderParserHandler
Обработка полей запроса.
Листинг
PythonAccessHandler
Обработка ограничений доступа (например, по IP–адресу).
Листинг
PythonAuthenHandler
Идентификация пользователя.
Листинг
PythonTypeHandler
Определение и/или настройка типа документа, языка и т.д.
Листинг
PythonFixupHandler
Изменение полей непосредственно перед вызовом обработчиков содержимого.
Листинг
PythonHandler
Основной обработчик запроса.
Листинг
PythonInitHandler
PythonPostReadRequestHandler или PythonHeaderParserHandler в зависимости от нахождения в конфигурации web–сервера.
Листинг
PythonLogHandler
Управление записью в логи.
Листинг
PythonCleanupHandler
Обработчик, вызываемый непосредственно перед уничтожением Request–объекта.
Некоторые из этих обработчиков работают только глобально, так как при вызове даже каталог их приложения может быть неизвестен (таков, например, PythonPostReadRequestHandler).
С помощью mod_python можно строить web–сайты с динамическим содержимым и контролировать некоторые аспекты работы web–сервера Apache через Python–сценарии.
Читать дальше