12. Встроенный perl


    Exim может быть собран с встроенным интерпретатором perl. Когда это сделано, подпрограммы perl можно вызывать как часть процесса раскрытия. Для использования поддержки perl, вам ружна установленная в системе версия 5.004, или более поздняя. Для включения встроенного интерпретатора perl в бинарный файл exim`a, включите строку

EXIM_PERL = perl.o


в ваш Local/Makefile , и затем соберите exim обычным способом.

12.1 Настройка использования perl

   Доступ к подпрограммам perl осуществляется через глобальную конфигурационную опцию perl_startup , и опреатор раскрытия ${perl ...} . Если опция perl_startup отсутствует в конфигурационном файле exim, тогда интерпретатор perl не запускается, и для exim почти нет накладных расходов (т.к. ни одна библиотек perl не использует страницы памяти). Если опция perl_startup присутствует, тогда ассоциированное значение берётся чтобы быть кодом perl, выполняемым во вновь созданном интерпретаторе perl.
   Значение
perl_startup не раскрывается в смысле exim`a, таким образом, вам не нужно добавлять символ обратного слэша перед символами имеющими специальное значение. Опция, обычно, выглядит так

perl_startup = do '/etc/exim.pl'


где /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 . Оператор используется в любой из следующих форм:

    
    ${perl{foo}}
    ${perl{foo}{argument}}
    ${perl{foo}{argument1}{argument2} ... }
    
    
    

    вызывающих подпрограмму foo с заданными параметрами. Может быть передано, максимум, восемь параметров. Передача большего числа приводит к ошибке раскрытия, с сообщением об ошибке, такой формы:

    Too many arguments passed to Perl subroutine "foo" (max is 
    8
    )
    
    
    

       Возвращаемое значение подрограммы perl оценивается в скалярных величинах до возвращения его exim`у, чтобы быть вставленным в раскрытую строку. Если возвращённое значение - undef , раскрытие терпит принудительную неудачу таким же образом, как и явный fail в элементе if или lookup. Если подпрограмма прерывается повинуясь функции perl`a die , раскрытие неудачно, с сообщением об ошибке, которое переданно die .

    12.3 Вызов функций exim`a из perl`a

       Внутри любого кода perl, вызыванного из exim, доступна функция Exim::expand_string() , для обратного вызова в функцию раскрытия exim. Для примера, код perl

    my $lp = Exim::expand_string('$local_part');
    
    
    

    сделает текущую переменную 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 , вам необходимо это:

    
    $SIG{__WARN__} = sub { };
    
    
    

       Всякий раз, когда появляется warn , вызывается безымянная программа. В этом примере, код программы пуст, таким образом, она ничего не делает, но вы можете включить любой код perl, который вам нравится. Текст сообщения warn передаётся как первый параметра подпрограммы.




    =============
    Автор перевода: lissyara, оригинал: http://www.lissyara.su/?id=1200