Программирование CGI на Perl
Что такое CGI
В настоящее время CGI поддерживается NCSA. NCSA определяет CGI следующим образом:
CGI (Common Gateway Interface), общий интерфейс шлюза, — это программа, которая работает на сервере, таком как HTTP-сервер, и предоставляет интерфейс для клиентских HTML-страниц.
Просмотр веб-страниц
Чтобы лучше понять, как работает CGI, мы можем начать с процесса щелчка по ссылке или URL на веб-странице:
- 1. Используйте браузер, чтобы открыть URL и подключиться к веб-серверу HTTP.
- 2. После получения запроса веб-сервер разбирает URL и проверяет, существует ли запрошенный файл на сервере. Если он существует, возвращается содержимое файла; в противном случае возвращается сообщение об ошибке.
- 3. Браузер получает информацию от сервера и отображает полученный файл или сообщение об ошибке.
Программы CGI могут быть скриптами Python, скриптами Perl, Shell-скриптами, программами на C или C++ и т. д.
Схема архитектуры CGI

Поддержка и настройка веб-сервера
Прежде чем начать программирование CGI, убедитесь, что ваш веб-сервер поддерживает CGI и что обработчик CGI настроен.
Настройка CGI в Apache:
Настройте каталог CGI:
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
Все CGI-программы, выполняемые HTTP-серверами, хранятся в предварительно настроенном каталоге. Этот каталог называется каталогом CGI, и по соглашению он имеет имя /var/www/cgi-bin.
Файлы CGI имеют расширение .cgi. Perl также может использовать расширение .pl.
По умолчанию серверы Linux настроены так, что /var/www используется как каталог cgi-bin для запуска CGI-скриптов.
Если вы хотите указать другой каталог для запуска CGI-скриптов, вы можете изменить файл конфигурации httpd.conf следующим образом:
<Directory "/var/www/cgi-bin"> AllowOverride None Options +ExecCGI Order allow,deny Allow from all </Directory>
Добавьте суффикс .pl в AddHandler, чтобы мы могли получать доступ к файлам скриптов Perl, оканчивающимся на .pl:
AddHandler cgi-script .cgi .pl .py
Первая CGI-программа
Ниже мы создаем файл test.cgi со следующим кодом:
Код test.cgi
Затем откройте http://localhost/cgi-bin/test.cgi в браузере, и вывод будет следующим:

Вывод 'Content-type:text/html\r\n\r\n' в первой строке скрипта отправляется в браузер, чтобы сообщить браузеру, что тип содержимого для отображения — 'text/html'.
HTTP-заголовок
Строка 'Content-type:text/html' в содержимом файла test.cgi является частью HTTP-заголовка. Она отправляется браузеру, чтобы сообщить ему тип содержимого файла.
Формат HTTP-заголовка следующий:
HTTP 字段名: 字段内容
Например:
Content-type:text/html\r\n\r\n
В следующей таблице описана информация, часто используемая в HTTP-заголовках в CGI-программах:
| head | Описание |
|---|---|
| Content-type: | MIME-информация, соответствующая запрошенной сущности. Например: Content-type:text/html |
| Expires: Дата | Дата и время истечения срока действия ответа |
| Location: URL | Используется для перенаправления получателя на местоположение, отличное от запрошенного URL, для завершения запроса или идентификации нового ресурса |
| Last-modified: Дата | Время последнего изменения запрошенного ресурса |
| Content-length: N | Длина содержимого запроса |
| Set-Cookie: Строка | Установка HTTP Cookie |
Переменные среды CGI
Все CGI-программы получают следующие переменные среды, которые играют важную роль в CGI-программах:
| Имя переменной | Описание |
|---|---|
| CONTENT_TYPE | Значение этой переменной среды указывает MIME-тип передаваемой информации. В настоящее время переменная среды CONTENT_TYPE обычно имеет значение: application/x-www-form-urlencoded, что указывает на то, что данные поступают из HTML-формы. |
| CONTENT_LENGTH | Если метод передачи между сервером и CGI-программой — POST, эта переменная окружения содержит количество допустимых байтов данных, которые можно прочитать из стандартного ввода STDIN. Эту переменную окружения необходимо использовать при чтении входных данных. |
| HTTP_COOKIE | Содержимое COOKIE на стороне клиента. |
| HTTP_USER_AGENT | Предоставляет информацию о браузере клиента, содержащую номера версий или другие проприетарные данные. |
| PATH_INFO | Значение этой переменной окружения представляет дополнительную информацию о пути, сразу следующую за именем CGI-программы. Часто она выступает в качестве параметра CGI-программы. |
| QUERY_STRING | Если метод передачи между сервером и CGI-программой — GET, значение этой переменной окружения представляет собой переданную информацию. Эта информация следует за именем CGI-программы и отделяется знаком вопроса '?'. |
| REMOTE_ADDR | Значение этой переменной окружения — IP-адрес клиента, выполняющего запрос, например 192.168.1.67 выше. Это значение присутствует всегда. Оно также является уникальным идентификатором, который веб-клиент должен предоставить веб-серверу, и может использоваться в CGI-программах для различения разных веб-клиентов. |
| REMOTE_HOST | Значение этой переменной окружения содержит имя хоста клиента, отправившего CGI-запрос. Если сервер не поддерживает нужный вам поиск, эта переменная окружения может быть не определена. |
| REQUEST_METHOD | Предоставляет метод, с помощью которого был вызван сценарий. Для сценариев, использующих протокол HTTP/1.0, имеют смысл только GET и POST. |
| SCRIPT_FILENAME | Полный путь к CGI-сценарию |
| SCRIPT_NAME | Имя CGI-сценария |
| SERVER_NAME | Это имя хоста, псевдоним или IP-адрес вашего веб-сервера. |
| SERVER_SOFTWARE | Значение этой переменной окружения содержит имя и номер версии HTTP-сервера, который вызвал CGI-программу. Например, приведённое выше значение — Apache/2.2.14(Unix). |
Ниже приведён простой CGI-скрипт, который выводит переменные среды CGI:
Пример
Скачивание файла
Если мы хотим реализовать скачивание файла через Perl CGI, нам нужно задать разные заголовки, как показано ниже:
Пример
Использование метода GET для передачи данных
Метод GET отправляет закодированную информацию пользователя на сервер. Данные включаются в URL запрашиваемой страницы и отделяются знаком '?', как показано ниже:
http://www.test.com/cgi-bin/test.cgi?key1=value1&key2=value2Некоторые другие замечания о GET-запросах:
- GET-запросы могут кэшироваться
- GET-запросы остаются в истории браузера
- GET-запросы можно добавлять в закладки
- GET-запросы не следует использовать при обработке конфиденциальных данных
- GET-запросы имеют ограничение длины
- GET-запросы следует использовать только для получения данных
Простой пример URL: метод GET
Ниже приведён простой URL, который отправляет два параметра программе test.cgi с использованием метода GET:
/cgi-bin/test.cgi?name=Example&url=http://www.example.com
Ниже приведён код для файла test.cgi:
Пример
Просмотрите в браузере, вывод будет следующим:

Простой пример формы: метод GET
Ниже представлена HTML-форма, которая использует метод GET для отправки двух элементов данных на сервер. Серверный скрипт, на который выполняется отправка, также является файлом test.cgi. Код файла test.html выглядит следующим образом:
Код файла test.html
В браузере результат выполнения следующий:

Использование метода POST для передачи данных
Использование метода POST для передачи данных на сервер безопаснее и надёжнее. Конфиденциальную информацию, такую как пароли пользователей, необходимо передавать с помощью POST.
Ниже также приведён test.cgi; он также может обрабатывать данные POST-формы, отправленные браузером:
Код test.cgi
Ниже представлена HTML-форма, которая использует метод GET для отправки двух элементов данных на сервер. Серверный скрипт, на который выполняется отправка, также является файлом test.cgi. Код файла test.html выглядит следующим образом:
Код test.html
В браузере результат выполнения следующий:
Передача данных флажка через CGI-программу
Флажок используется для отправки данных одной или нескольких опций. Код test.html выглядит следующим образом:
Код test.html
Ниже приведён код файла test.cgi:
Код test.cgi
В браузере результат выполнения следующий:
Передача данных радиокнопки через CGI-программу
Радиокнопка отправляет на сервер только один элемент данных. Код test.html выглядит следующим образом:
Код test.html
Код скрипта test.cgi выглядит так:
Код test.cgi
В браузере результат выполнения следующий:

Передача данных Textarea через CGI-программу
Textarea отправляет несколько строк данных на сервер. Код test.html выглядит так:
Код test.html
Код скрипта test.cgi выглядит так:
Код test.cgi
В браузере результат выполнения следующий:

Передача данных выпадающего списка через CGI-программу
Код HTML-поля выпадающего списка выглядит следующим образом:
Код test.html
Код скрипта test.cgi выглядит так:
Код test.cgi
В браузере результат выполнения следующий:

Использование куки в CGI
Существенный недостаток протокола HTTP заключается в том, что он не определяет личность пользователя, что создаёт большие неудобства для программистов. Появление функциональности куки восполняет этот недостаток.
Куки — это когда клиент посещает скрипт и через браузер клиента данные записываются на жёсткий диск клиента. Когда клиент в следующий раз обращается к скрипту, извлекается информация, содержащаяся в этих данных, тем самым достигается функция определения личности. Куки обычно используются для проверки подлинности.
Синтаксис куки
HTTP-куки отправляются через HTTP-заголовок, что происходит до передачи файла. Синтаксис заголовка Set-Cookie выглядит следующим образом:
Set-cookie:name=name;expires=date;path=path;domain=domain;secure
- name=name:Необходимо задать значение куки (в name нельзя использовать ";",символ), когда есть несколько значений name, используйте ";" для разделения, например:name1=name1;name2=name2;name3=name3。
- expires=date:Срок действия куки, формат: expires="Wdy,DD-Mon-YYYY HH:MM:SS"
- path=path: Задаёт путь, поддерживаемый куки. Если path — это путь, куки действует для всех файлов и подкаталогов в этом каталоге, например: path="/cgi-bin/". Если path — это файл, куки действует только для этого файла, например: path="/cgi-bin/cookie.cgi".
- domain=domain:Доменное имя, для которого действует куки, например: domain="www.example.com"
- secure:Если указан этот флаг, это означает, что куки могут передаваться только через HTTPS-сервер с использованием протокола SSL.
- Приём куки реализуется путём установки переменной среды HTTP_COOKIE. CGI-программы могут получать информацию о куки, запрашивая эту переменную.
Установка куки
Установка куки очень проста; куки отправляются отдельно в HTTP-заголовке. В следующем примере в куки задаются UserID, Password и expires:
Пример
Извлечение cookie
Страница извлечения информации о cookie очень проста. Информация о cookie хранится в переменной окружения CGI HTTP_COOKIE в следующем формате:
Пример
Результат вывода приведённого выше примера:
User ID = XYZ Password = XYZ123
Модуль CGI
Perl предоставляет множество встроенных CGI-модулей, обычно используются следующие два:
Другие расширения