Руководство для разработчиков

Переменные окружения

При выполнении кода обработчиков ispmanager передает им информацию через переменные окружения:

  • PARAM_[имя параметра запроса] - в таких переменных передаются параметры запроса к обработчику, в том числе значения полей формы (см. пример ниже), параметры фильтрации таблиц и т.п. Всегда доступна переменная PARAM_func, так как обработчик всегда обрабатывает ту или иную функцию (func), и при использовании одного обработчика для нескольких функций эта переменная позволяет менять поведение обработчика в зависимости от вызываемой функции;
  • AUTH_USER - имя пользователя ispmanager. В данном случае речь идет о пользователе, чье действие привело к выполнению обработчика; сам исполняемый файл обработчика всегда выполняется от пользователя root;
  • AUTH_LEVEL - уровень доступа пользователя ispmanager (30 - root, 29 - администратор, 16 - обычный пользователь, 9 - пользователь почтового ящика);
  • HTTP_[ИМЯ_ЗАГОЛОВКА_ЗАПРОСА] - переменные с значениями заголовков HTTP-запроса, сделанного веб-клиентом ispmanager, который привел к выполнению обработчика. В качестве примера можно привести переменную HTTP_USER_AGENT, соответствующую заголовку HTTP-запроса User-Agent, по которому можно определить используемый пользователем браузер. При формировании имен переменных все буквы в соответствующих именах заголовков преобразуются в заглавные и дефисы (-) превращаются в нижние подчеркивания (_).

Пример использования значений полей формы в обработчике.