В этой статье я хотел бы
продемонстрировать, что создание работоспособных и полезных динамических web-узлов
вовсе не такая сложная задача, как может показаться при чтении текстов, описывающих
интерфейс cgi. На самом деле подобная работа (по крайней мере, при использовании linux)
больше всего напоминает игру the incredible machines, где нужно кремнем высечь искру,
чтобы свет упал на солнечную батарею, от которой срабатывает сверхсовременный
компьютер. Здесь тоже все, как правило, собирается из компонентов, которые оказались
под рукой.
В качестве примера мы рассмотрим создание почтовой службы на web-сервере - webmail -
на основе языка php3 с максимальным использованием готовых компонентов. За кадром
останутся создание новых пользователей, их регистрация в базе данных и т. п. Наша
почта, кроме того, не будет обрабатывать письма с вложениями и в кодировках, отличных
от koi8-r, поддерживать записные книжки и т. п. - все это лишь увеличило бы размеры
сценариев, не дав ничего принципиально нового.
Компоненты Вначале о "готовых компонентах". Я уже упомянул о том, что все описанное
ниже рассчитано на использование linux. Однако существующие дистрибутивы этой ОС
настолько различаются по комплектации, что вряд ли удастся построить пример, который
годился бы для любой версии. Поэтому я ограничусь версией, с которой лучше всего
знаком, - ksi-linux 2.0 (http://www.ksi-linux.com). Если у вас другой вариант linux,
например redhat 5.2 или debian 2.0, то вам, скорее всего, потребуется получить
некоторые компоненты из internet или перекомпилировать уже имеющиеся.
Нам понадобятся web-сервер russian apache 1.3.x rus/pl 27.4, php 3.0.6 с поддержкой
протокола imap4r1 и почтовый сервер imap4r1. Благодаря russian apache мы будем, по
крайней мере отчасти, избавлены от проблем с кодировками: независимо от кодировки,
используемой клиентом, данные на сервер всегда будут посылаться в koi8-r (это настройка
russian apache по умолчанию). Сервер imap4r1 позволит нам манипулировать почтовым
ящиком, не описывая в явной форме права доступа (связываясь с этим сервером, вы
указываете свое имя и пароль, и он сам решает все проблемы с правами). И наконец, php
3.0.6 с поддержкой протокола imap4r1 даст возможность работать с сервером imap4r1, не
реализуя самостоятельно соответствующий протокол, который весьма и весьма нетривиален.
Здесь многие зададут вопрос: а почему не perl? Дело в том, что, хотя язык perl -
стандартная "рабочая лошадка" для создания web-узлов, у него есть определенные
недостатки. Интерпретатор perl существенно сложнее интерпретатора php и требует для
работы больше ресурсов компьютера. Кроме того, это не интерпретатор в точном смысле
слова: он компилирует программу в специализированный псевдокод, который затем
немедленно исполняется. Если в программе есть циклы, такой подход может дать
существенный выигрыш, но если нет (как это часто бывает в простых сценариях для
web-сервера - например, во всей нашей реализации webmail будет всего один цикл),
накладные расходы не окупаются. Применение mod_perl - дополнительного модуля apache -
позволяет избежать многократной перекомпиляции сценариев, но при этом к памяти сервера
предъявляются еще более высокие требования.
Коротко о php Теперь несколько слов о том, что же такое php. Это интерпретируемый
язык для создания активных web-страниц. Программа на php, подобно тексту на javascript,
vbscript или asp, вставляется в html-файл. Начало и конец программы отмечаются
специальными скобками <?php и ?>. Текст вне этих скобок php не интерпретирует: он
передается web-браузеру "как есть". В листинге 1 приведена реализация на php "вечного"
примера - счетчика. Как видите, это совершенно обычный html-файл, однако в том месте,
где должно стоять количество посещений, стоит сценарий на php3, который в качестве
результата своей работы выводит число посещений страницы1.
Синтаксис php основан на синтаксисе языков Си, java и perl и довольно подробно описан
в руководстве, которое входит в комплект поставки (его также можно взять на узле
http://www.php.net/). Способы заставить сервер правильно реагировать на html-файлы со
вставками на php, вообще говоря, различны для разных серверов, но чаще всего бывает
достаточно дать имени файла расширение .php3.
Итак, мы хотели бы иметь возможность читать и отправлять почту с помощью
web-браузера. Видимо, будет разумно сделать интерфейс похожим, скажем, на netscape
messenger: окно разделено по горизонтали на две части, в верхней находится список писем
в нашем почтовом ящике на сервере, в нижней - текущее письмо. Но перед тем как показать
пользователю html-файл с описанием фреймов, мы потребуем от него ввести свое имя и
пароль (при неправильно введенном пароле он получит файл, содержащий сообщение об
ошибке). Эту функцию будет осуществлять файл index.php3, показанный в листинге 2.
Давайте посмотрим на него поближе.
Прежде всего стоит обратить внимание на то, что скобка <?php, открывающая
php-сценарий, стоит в самом начале файла. Это не случайно. Дело в том, что не нужно
сообщать браузеру о том, что документ состоит из нескольких фреймов, пока пользователь
не введет правильные имя и пароль. Чтобы запросить пароль, мы меняем "ответ сервера" с
обычного "200 ok" на "401 auth required"2. Это очень просто: специально для подобных
случаев в php предусмотрена функция header(). Но эта функция работает только при
условии, что перед ее вызовом вывод документа еще не был начат, и следовательно, скобка
<?php должна стоять в самом начале файла...
Дальнейшее очевидно: мы смотрим на введенное пользователем имя и пароль, пытаемся
связаться с сервером imap4r1 и, если все прошло успешно, просто выдаем информацию о
наборе фреймов. Однако теперь во все сценарии в том подкаталоге, где размещается наш
стартовый файл index.php3, будет передаваться информация об имени и пароле!3
Заметим также, что перед именем функции imap_open стоит символ "@". Он означает, что
сообщения о возможных ошибках при работе функции должны не выводиться в текст на html
(поведение php по умолчанию), а сохраняться в специальной переменной. Это необходимо
для того, чтобы воспользоваться функцией header(): она не будет работать, если в тело
документа уже выведен какой бы то ни было текст, в том числе и сообщение об ошибке.
Другие файлы Теперь нам нужно создать файлы top.php3 и main.php3, на которые имеются
ссылки в index.php3. Начнем с top.php3 (листинг 3). В нем мы строим таблицу, в которой
каждая строка соответствует одному письму и содержит его порядковый номер, тему, имя
(адрес) отправителя и дату отправки. Вся информация извлекается из соответствующих
полей заголовка письма.
При оформлении ссылок (href) мы должны не забыть передать номер письма (как при
работе с обычным cgi-сценарием). Файл main.php3 (листинг 4) проверяет, установлена ли
переменная $mail. Если нет, то выводится только надпись new message с соответствующей
ссылкой, а если да, добавляются еще две ссылки - reply и delete. Кроме того, ссылки,
встречающиеся в тексте письма, заменяются на ссылки html. Файлы mail.php3, del.php3 и
send.php3 (листинги 5-7) устроены предельно просто, однако, так как файлы del.php3 и
send.php3 содержат вызовы функции header(), они начинаются со скобки <?php. На сей раз
эти вызовы нужны для того, чтобы сообщение об успешной посылке или удалении письма
заменилось на основное окно автоматически, без каких бы то ни было действий со стороны
пользователя.
Чего мы не сделали Вот и все. Служба webmail готова (см. рисунок). Как несложно
заметить, мы всего лишь соединили готовые части - все наши шесть файлов не насчитывают
и двух сотен строк - и получили почти настоящую почтовую программу. Конечно, с ней
связаны и некоторые проблемы. Например, такие.
1. Что будет, если с помощью нашей webmail попробовать читать почту одновременно с
двух компьютеров? При удалении письма на одном компьютере нумерация "съедет", и на
втором начнут происходить весьма неприятные вещи. 2. Как уже было замечено, на сервере
с не полностью контролируемым содержанием использование нашей программы может привести
к попаданию паролей в нечистые руки. 3. Нет поддержки кодировок, отличных от koi8-r,
для почты (при том, что для web-браузера благодаря russian apache поддерживаются все
распространенные кодировки). 4. Нет поддержки вложений. 5. Нет записной книжки. 6. Нет
поддержки папок.
Впрочем, мы и не ставили себе целью создать программу, способную сравниться с eudora
или pegasus (но, кстати, программа imap webmail program - см. http://web.horde.org/imp/
- очень близка к этому).
Сделаем еще несколько замечаний по поводу возможных решений первой и второй проблемы.
Эти проблемы связаны с обеспечением безопасности, а значит, требуют особого внимания.
Для решения первой проблемы можно передавать в дополнение к номеру письма еще и
идентификатор сообщения (messageid); это, однако, повлечет существенное усложнение
программы, так как нужно будет организовать подробное "разбирательство" в случае
несовпадения идентификаторов, а также корректное обновление списка писем.
Вторая проблема решается путем добавления еще одной формы на входе и передачи имени
пользователя и пароля от сценария к сценарию через url - так, как сейчас передается
номер письма. Но тогда пароль будет появляться в адресной строке браузера. С этим можно
бороться двумя способами - либо зашифровывая пароль перед посылкой и расшифровывая при
получении, либо создав еще два фрейма: первый не используется никак (или в нем
размещается реклама, что, в общем, то же самое), во втором происходит вся работа. Можно
и скомбинировать названные способы. Дерзайте!
ЛИСТИНГ 1 Файл counter.php3 (счетчик числа посещений web-страницы)
<html> <body bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#800080"
alink="#ff0000"> <p> Число посещениий: <?php $filename = "counter.dat"; $fp =
@fopen($filename,"r"); if ($fp) { $counter=fgets($fp,10); fclose($fp); } else {
$counter=0; } $counter++; print $counter; $fp = fopen($filename,"w"); if ($fp) {
$counter=fputs($fp,$counter); fclose($fp); } ?> </body> </html>
ЛИСТИНГ 2 Файл index.php3 (идентификация пользователя, установление контакта с
почтовым сервером и создание набора фреймов для вывода списка писем и текста текущего
письма)
<?php $realm = "web mail"; $popserver = ‘127.0.0.1’; $logerrors = 1;
if(!isset($php_auth_user)): header( "www-authenticate: basic realm="$realm"");
header( "http/1.0 401 unauthorized"); echo "<h1>authorization required</h1>n"; exit;
else: if(!($imap_stream=@imap_open("{127.0.0.1:143}inbox","$php_
auth_user","$php_auth_pw",op_readonly))): header( "www-authenticate: basic
realm="$realm""); header( "http/1.0 401 auth required"); echo "<h1>authorization
required</h1>n"; exit; else: imap_close($imap_stream); ?> <html> <frameset border="0"
framespacing="-2" rows="20%,80%"> <frame src="top.php3" name="top" marginwidth="1"
marginheight="1" framespacing="0"> <frame src="main.php3" name="main" marginwidth="1"
marginheight="1" framespacing="0"> </frameset> <noframes> <body> sorry, but your
browser does not support frames...<br> </body> </noframes> </html> <?php endif; endif;
?>
ЛИСТИНГ 3 Файл top.php3 (формирование списка писем)
<html> <body bgcolor="#c04040" text="#ffffff" link="#0000ff" vlink="#800080"
alink="#ff0000"> <base target="main"> <?php
$imap_stream=imap_open("{127.0.0.1:143}inbox","$php_auth_user",
"$php_auth_pw",op_readonly); $inbox=imap_mailboxmsginfo($imap_stream); ?>
<center><table border=3 width="100%">
<tr><th>nn</th><th>subject</th><th>from</th><th>date</th></tr> <tr><td> <?php
for($i=1;$i<=$inbox->nmsgs;$i++): $header=imap_header($imap_stream,$i,300,300,0); echo
"<tr><td><b><a href=main.php3?mail=".$i. ">".$i. "</a></b></td><td><a
href=main.php3?mail=".$i. ">".$header->subject. "</a></td><td><a
href=main.php3?mail=".$i. ">".$header->fromaddress. "</a></td><td><a
href=main.php3?mail=".$i. ">".$header->date. "</a></td></tr>"; endfor;
imap_close($imap_stream); ?> </table> </center> </body> </html>
ЛИСТИНГ 4 Файл main.php3 (проверка наличия писем и вывод кнопок)
<html> <body bgcolor="#408080" text="#ffffff" link="#0000ff" vlink="#800080"
alink="#ff0000"> <base target="main"> <a href=mail.php3>new message</a> <?php if
(isset($mail) && ($mail>=1)):?>| <a href=mail.php3?mail=<?php echo $mail;?>> reply</a>|
<a href=del.php3?mail=<?php echo $mail;?>target= _top>delete</a><?php endif;?><br><br>
<?php if(isset($mail) && ($mail>=1)):
$imap_stream=imap_open("{127.0.0.1:143}inbox","$php_auth_user",
"$php_auth_pw",op_readonly); $inbox=imap_mailboxmsginfo($imap_stream);
$body=imap_fetchbody($imap_stream,$mail,1,0); print(nl2br(eregi_replace(
"(http|https|ftp)://([-=%_ a-za-z0-9./~?:]+)", "<a href="\1://\2" target="_blank
">\1://\2</a>", htmlspecialchars($body)))); imap_close($imap_stream); endif; ?>
</body> </html>
ЛИСТИНГ 5 Файл mail.php3 (создание письма)
<html> <body bgcolor="#408080" text="#ffffff" link="#0000ff" vlink="#800080"
alink="#ff0000"> <base target="main"> <?php if (isset($mail) && ($mail>=1)):
$imap_stream=imap_open("{127.0.0.1:143}inbox","$php_auth_user",
"$php_auth_pw",op_readonly); $header=imap_header($imap_stream,$mail,300,300,0); endif;
?> <form action=’send.php3’ method=’post’> <table border=0 cellspacing=0 cellpadding=0
width=100%> <tr> <td class=light width="150"> <b><b>your name :</b></b> </td><td
colspan=2 class=light> <input type="text" name="sendername" value="<?php echo
$sendername;?>" size=60 maxlength=70> </td></tr> <tr> <td class=light width="150">
<b><b>from :</b></b> </td><td colspan=2 class=light> <input type="text" name="sender"
value="<?php echo $php_auth_user."@host.some_domain.com";?>" size=60 maxlength=70>
</td></tr> <tr> <td class=light width="150"> <b><b>subject :</b></b> </td><td colspan=2
class=light> <input type="text" name="subject" value="<?php if (isset($mail) &&
($mail>=1)):?>re: <?php echo eregi_replace(""",""",$header->subject); endif;?>"
size=60 maxlength=70> </td></tr> <tr> <td class=light width="150"> <b><b>to :</b></b>
</td><td colspan=2 class=light> <input type="text" name="mailto" value="<?php if
(isset($mail) && ($mail>=1)): echo eregi_replace (""",""",$header->fromaddress);
endif;?>" size=60 maxlength=70> </td></tr> <tr> <td class=light width="150"> <b>message
body : </td><td colspan=2 class=light> <textarea name="text" rows=15 cols=59><?php if
(isset($mail) && ($mail>=1)): echo "> ".eregi_replace ("n","n>
",htmlspecialchars(imap_fetchbody ($imap_stream,$mail,1,0))); endif;?></textarea>
<center><input type=submit value="send"></center><br> </td></tr> </table> </form>
</body> </html> <?php if (isset($mail) && ($mail>=1)):imap_close($imap_stream);endif;
?>
ЛИСТИНГ 6 Файл del.php (удаление письма)
<html> <body bgcolor="#408080" text="#ffffff" link="#0000ff" vlink="#800080"
alink="#ff0000"> <base target="main"> <?php if (isset($mail) && ($mail>=1)):
$imap_stream=imap_open("{127.0.0.1:143}inbox","$php_auth_user",
"$php_auth_pw",op_readonly); $header=imap_header($imap_stream,$mail,300,300,0); endif;
?> <form action=’send.php3’ method=’post’> <table border=0 cellspacing=0 cellpadding=0
width=100%> <tr> <td class=light width="150"> <b><b>your name :</b></b> </td><td
colspan=2 class=light> <input type="text" name="sendername" value="<?php echo
$sendername;?>" size=60 maxlength=70> </td></tr> <tr> <td class=light width="150">
<b><b>from :</b></b> </td><td colspan=2 class=light> <input type="text" name="sender"
value="<?php echo $php_auth_user."@host.some_domain.com";?>" size=60 maxlength=70>
</td></tr> <tr> <td class=light width="150"> <b><b>subject :</b></b> </td><td colspan=2
class=light> <input type="text" name="subject" value="<?php if (isset($mail) &&
($mail>=1)):?>re: <?php echo eregi_replace (""",""",$header->subject); endif;?>"
size=60 maxlength=70> </td></tr> <tr> <td class=light width="150"> <b><b>to :</b></b>
</td><td colspan=2 class=light> <input type="text" name="mailto" value="<?php if
(isset($mail) && ($mail>=1)): echo eregi_replace (""",""",$header->fromaddress);
endif;?>" size=60 maxlength=70> </td></tr> <tr> <td class=light width="150"> <b>message
body : </td><td colspan=2 class=light> <textarea name="text" rows=15 cols=59><?php if
(isset($mail) && ($mail>=1)): echo "> ".eregi_replace ("n","n>
",htmlspecialchars(imap_fetchbody ($imap_stream,$mail,1,0))); endif;?></textarea>
<center><input type=submit value="send"></center><br> </td></tr> </table> </form>
</body> </html> <?php if (isset($mail) && ($mail>=1)):imap_close($imap_stream);endif;
?>
ЛИСТИНГ 7 Файл send.php3 (отправка письма)
<?php header("refresh: 5;url=main.php3"); ?> <html> <body bgcolor="#408080"
text="#ffffff" link="#0000ff" vlink="#800080" alink="#ff0000"> <base target="main">
<?php mail($mailto,$subject,$text,"from: $sendername <$sender>ncontent-type:
text/plain; charset=koi8-r"); ?> message was succesfully sent. </body> </html>
--------------------------------------------------------------------------------
1 Сценарий намеренно предельно упрощен: он не заботится о блокировке файлов, не
обрабатывает ошибки записи на диск и т. п. Заметим, что наш счетчик, в отличие от
большинства других, написан без использования тега <img>. Это позволяет сократить
трафик и решает проблему неграфических браузеров (например, браузеров для слепых), но
может создать проблемы, если нам нужен единый счетчик для нескольких "зеркал" основного
узла. "Традиционная" реализация счетчика в php также не представляет проблемы,
поскольку он имеет множество функций для порождения gif-файлов (включая даже получение
красивых надписей, выполненных шрифтами truetype).
2 Число 401 взято не с потолка, а из описания протокола http.
3 К сожалению, если в каком-либо другом подкаталоге указать realm="web mail", то
находящиеся в нем сценарии также получат соответствующую информацию. Поэтому данный
метод неприемлем, если вы не можете контролировать содержимое всего узла. В конце
статьи мы обсудим, как обойти это ограничение.