Внимание! Начиная с версии 7.02 сборки PHP-Fusion-AP-Rus выпускаются под названием AP-Fusion. Поддержка осуществляется на сайте http://ap-fusion.ru.

Библиотека ITCGI

Первое, с чего хочу начать этот параграф, так это объяснить, зачем, собственно, нам понадобилось изобретать велосипед и чем наш велосипед лучше других.

Изначально, первые свои CGI-программы для WEB мы писали на языке Perl. Они были не очень сложными. Далее, когда возникли задачи более серьезные, связанные с системным программированием, с базами данных, мы приняли решение перейти на Си/C++. Многие сторонники языка Perl утверждают, что он ни чем не хуже. Может быть, если не знать Си/С++. Конечно, это вопрос очень спорный. Можно долго отстаивать свое мнение, но так ни к чему и не прийти. На нашем сайте http://perl.org.ru в форуме как-то возникла такая дискуссия, но так ничем и не закончилась. Мой хороший знакомый, автор и создатель сайта http://dore.ru, сторонник языка Perl. В скриптовых языках типа Perl, PHP или Unix-shell я вижу только два существенных преимущества.

1. автоматическое приведение типов
2. формирование строк на лету

1. Системные вещи пишутся на Си. Не будет проблем интеграции с любым API, например, вы можете использовать функции системных библиотек, использовать OpenGL - библиотеку трехмерной графики для создания графических сцен.
2. Результатом является исполняемый файл, а значит работать будет быстрее. А также в случае, если злоумышленник получит доступ на чтение к файлам в папке cgi-bin, то найти дырку в бинарном файле значительно сложнее, нежели прочитать исходник интерпретируемого языка типа Perl или PHP.
3. Си имеет гораздо большую сферу применения. Вам не надо изучать синтаксис нового языка, чтобы начать писать игры, приложения баз данных или записную книжку.
4. Язык С++ хорошо соответствует объектно-ориентированной парадигме.
5. Си\C++ языки профессионалов.
6. И решающим фактором был опыт работы, у любого программиста нашей команды более 5 лет программирования на Си\С++.

1. Перед вызовом функций этих библиотек требуется начальная инициализация, а перед завершением работы, очистка памяти. В программе вы должны объявить переменную llist entries; и вызвать функцию read_cgi_input(&entries); Если начальная инициализация еще не вызывает хлопот, то вызов функции очистки памяти - list_clear(&entries); неприятен тем, что выходов из программы может быть несколько. И перед каждой инструкцией return вам придется писать list_clear(&entries);. В библиотеке ITCGI начальная инициализация выполняется при первом вызове любой функции, а завершающая очистка памяти происходит автоматически при завершении программы.
2. При получении значения параметра html-формы библиотеки cgiparse и cgihtml возвращают указатель на строку в их внутреннем буфере. Теперь, если вы по этому указателю запишите другое значение, или еще хуже, освободите память под ним, то при следующем запросе значения параметра вы получите уже другое значение - не то, что было в оригинале. Библиотека ITCGI выдает всегда копию строки.
3. Нам нужно было работать не только под unix, но и под windows. Под Windows мы использовали MFC и класс CString. Библиотека ITCGI имеет одинаковый интерфейс и под Unix и под Windows. В Windows ее реализация написана на С++ с использованием MFC. В Unix мы сделали все на чистом Си, написав свою структуру LString.
4. Библиотеки cgiparse и cgihtml не имели функций для считывания файла в строку, для замены в html-шаблоне переменных помеченных как %%var%% на их реальные значения, для обработки SSI-директивы include virtual и многих других.

1. работа с CGI-параметрами
2. Cookie - параметры на стороне клиента
3. Работа с параметрами на стороне сервера.
4. Функции общего назначения.
5. Работа с HTML.
6. Функции для работы с картинками GIF & JPEG

//listcgi.c
#include <itcgi.h>


int main()
{
LString* name = CreateString();  // строка для хранения имени параметра
LString* value = CreateString(); // его значения
int i, count;

count = GetCount();              // получаем общее количество параметров


printf("Content-type: text/html\n\n"); // печатаем заголовок документа

// выводим HTML-код таблицы
printf("<html><table border=\"1\"><caption>Полный список\
 cgi-параметров</caption><tr><td\
 bgcolor=\"E5E5E5\">Индекс<td bgcolor=\"E5E5E5\">Имя<td\
 bgcolor=\"E5E5E5\">Значение");
 
 // в цикле проходим по всем параметрам
for(i=0;i<count;i++)
{
 GetParamByIndex(i, value);    // получаем значение параметра по его индексу
 GetParamNameByIndex(i, name); // получаем имя параметра
 printf("<tr><td>%d <td> %s <td> %s\n", i, *name, *value);
}
printf("</table>");


DeleteString(name); // освобождаем память
DeleteString(value);
return 0;
}

===Makefile===
all: listcgi 

listcgi: listcgi.c itcgi.a
        gcc listcgi.c -L/usr/local/lib/mysql -I/usr/local/include/mysql \
        -L/usr/local/lib -I/usr/local/include \
-o listcgi -lmysqlclient /usr/lib/itcgi.a -Wall -O3 
        strip listcgi
        cp listcgi /www/members/cgi-bin/listcgi