| |
12. Встроенный perl
Exim может быть собран с встроенным интерпретатором perl. Когда это сделано, подпрограммы perl можно вызывать как часть процесса раскрытия. Для использования поддержки perl, вам ружна установленная в системе версия 5.004, или более поздняя. Для включения встроенного интерпретатора perl в бинарный файл exim`a, включите строку
|
в ваш “
Local/Makefile
”, и затем соберите exim обычным способом.
12.1 Настройка использования perl
Доступ к подпрограммам perl осуществляется через глобальную конфигурационную опцию “
perl_startup
”, и опреатор раскрытия “
${perl ...}
”. Если опция “
perl_startup
” отсутствует в конфигурационном файле exim, тогда интерпретатор perl не запускается, и для exim почти нет накладных расходов (т.к. ни одна библиотек perl не использует страницы памяти). Если опция “
perl_startup
” присутствует, тогда ассоциированное значение берётся чтобы быть кодом perl, выполняемым во вновь созданном интерпретаторе perl.“
Значение
perl_startup
” не раскрывается в смысле exim`a, таким образом, вам не нужно добавлять символ обратного слэша перед символами имеющими специальное значение. Опция, обычно, выглядит так
|
где “
/etc/exim.pl
” - код perl, определяющий любые подрограммы, которые вы хотите использовать с exim. Exim может быть сконфигурирован или для запуска интерпретатора perl сразу, или ждать первого раза, когда он понадобиться. Старт интепретатора в начале, гарантирует, что действие будет сделано в то время, когда exim имеет setuid привилегии, но может вызвать ненужные накладные расходя, если perl, фактически, не используется в выполняемой части. Кроме этого, отметтьте, что это не означает, что exim работает от root`a, при вызове perl`a в более поздние моменты времени. По дефолту, интерпретатор запускается только когда он необходим, и это может быть изменено в двух местах:
Установкой опции “
perl_at_start
” (булева опция) в конфигурации запрашивается запуск при начале работы exim`a.
Опция командной строки “
-ps
”, также вызывает запуск вместе с exim`ом, отменяя установку “
perl_at_start
”.
Также, есть опция командной строки “
-pd
” (для задержки), подавляющая начальный запуск, даже если уставновлена “
perl_at_start
”.
12.2 Вызов подпрограмм perl
Когда конфигурационный файл включает опцию “
perl_startup
”, вы можете использовать элемен раскрытия строк для вызова подрограмм perl, заданных кодом “
perl_startup
”. Оператор используется в любой из следующих форм:
|
вызывающих подпрограмму “
foo
” с заданными параметрами. Может быть передано, максимум, восемь параметров. Передача большего числа приводит к ошибке раскрытия, с сообщением об ошибке, такой формы:
|
Возвращаемое значение подрограммы perl оценивается в скалярных величинах до возвращения его exim`у, чтобы быть вставленным в раскрытую строку. Если возвращённое значение - “
undef
”, раскрытие терпит принудительную неудачу таким же образом, как и явный “fail” в элементе “if” или “lookup”. Если подпрограмма прерывается повинуясь функции perl`a “
die
”, раскрытие неудачно, с сообщением об ошибке, которое переданно “
die
”.
12.3 Вызов функций exim`a из perl`a
Внутри любого кода perl, вызыванного из exim, доступна функция “
Exim::expand_string()
”, для обратного вызова в функцию раскрытия exim. Для примера, код perl
|
сделает текущую переменную exim`a “
$local_part
”, доступной в переменной perl “
$ip
”. Отметтьте, что тут одиночные кавычки, а не двойные, для предотвращения интепретации “
$local_part
” как переменной perl.“
Если раскрытие строки принудительно сделано неуспешным, элементом fail”, результат “
Exim::expand_string()
” - “
undef
”. Если в строке раскрытия есть синтаксическая ошибка, из оригинального раскрытия строки вызывается ошибка perl, с соотвествующим сообщением об ошибке, таким же образом как будто использовалось “
die
”.“
Внутри кода perl доступны две другие функции exim.
Exim::debug_write()
” записывает строку в стандартный поток ошибок, если включена отладка exim. Если вы хотите добавлять в конец строки символ новой строки, вы его должны подставить. “
Exim::log_write()
” пишет строки в основной лог exim`a, добавляя в начале метку времени. В этом случае, вам не нужно добавлять перевод строки.
12.4 Использование стандартного вывода и ошибок perl`ом
Вы не должны записывать в стандартный поток ошибок, или стандартный вывод изнутри вашего кода perl, поскольку не заданы их установки. В версиях exim до 4.50, это возможно для стандартного вывода или стандартного потока ошибок, для ссылки на SMTP-соединение в течение приёма сообщения даемоном.Запись в этот поток вызывает хаос. С exim 4.50, прогресс, стандартные потоки ошибок и вывода соединены с “
/dev/null
”, в даемоне. Хаос отсутствует, но вывод потерян.“
Утверждение perl
warn
”, по умолчанию, пишется в стандартный поток ошибок. Вызовы “
warn
” могут быть встроены в модули perl, которые вы используете, но которые не контролируете. Когда exim запускает интерпретатор perl, он принимает меры для записи вывода утверждений “
warn
” в главный лог exim`a. Вы можете изменить это, путём включения соответсвующей perl`овой феньки, где-то внутри его кода. например, чтобы полностью отказаться от вывода “
warn
”, вам необходимо это:
|
Всякий раз, когда появляется “
warn
”, вызывается безымянная программа. В этом примере, код программы пуст, таким образом, она ничего не делает, но вы можете включить любой код perl, который вам нравится. Текст сообщения “
warn
” передаётся как первый параметра подпрограммы.
=============
Автор перевода: lissyara, оригинал: http://www.lissyara.su/?id=1200
Закладки на сайте
Проследить за страницей
Created 1996-2025 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру