cgic 写CGI程序

CGIC是C语言CGI库函数,用于编写CGI程序

CGIC 主要完成以下功能：

* 对数据进行语法分析

* 接收以 GET 和 PSOT 两种方式发送的数据

* 把 FORM 中的不同域连接成连续的串

* 为检索 FORM 数据而提供字符串 , 整数 , 浮点以及单项和多项选择功能

* 为数字字段提供边界检测

* 把 CGI 环境变量加载到非空的 C 串中

* 为调试而捕捉 CGI 状态

如何写CGIC应用程序

任何cgic 应用程序必须连接到cgic.c，如果在Linux 下可以用Makefile 做这个工作。

因为CGI 程序需要做一些初始化操作，如获取环境变量，分析数据等，所以cgic 库提供了自己的main()函数，那自己写的cgic程序不能再包含main()函数，而必须以cgiMain()函数开始，cgic.c会调用这个函数。当然这个函数名是可以更改的.还要注意的是，自己编写的cgic 程序必须包含#include<cigi.h>

也就是说cgic,已经做了一些相关的解析工作，在自己的main函数中只要调用cigic 中相应的函数便可。

以下是cigic 库里自带的cgic test程序的cgiMain()

[cpp] view plain copy

print ?

int cgiMain() {
#ifdef DEBUG
LoadEnvironment();
#endif /* DEBUG */
/* Load a previously saved CGI scenario if that button
has been pressed. */
if (cgiFormSubmitClicked("loadenvironment") == cgiFormSuccess) {
LoadEnvironment();
}
/* Set any new cookie requested. Must be done *before*
outputting the content type. */
CookieSet();
/* Send the content type, letting the browser know this is HTML */
cgiHeaderContentType("text/html");
/* Top of the page */
fprintf(cgiOut, "<HTML><HEAD> ");
fprintf(cgiOut, "<TITLE>cgic test</TITLE></HEAD> ");
fprintf(cgiOut, "<BODY><H1>cgic test</H1> ");
/* If a submit button has already been clicked, act on the
submission of the form. */
if ((cgiFormSubmitClicked("testcgic") == cgiFormSuccess) ||
cgiFormSubmitClicked("saveenvironment") == cgiFormSuccess)
{
HandleSubmit();
fprintf(cgiOut, "<hr> ");
}
/* Now show the form */
ShowForm();
/* Finish up the page */
fprintf(cgiOut, "</BODY></HTML> ");
return 0;
}

[cpp] view plain copy

print ?

#ifdef DEBUG
LoadEnvironment();
#endif /* DEBUG */

一般采用以上方式，调用环境变量用作调试。可以插入语句："#define DEBUG 1 将DEBUG模式打开。

cgiHeaderContentType("text/html") 这个函数主要是输出Content Type Header，告诉浏览器返回的是一个html页面，当然也可以是"image/gif", "image/jpeg" and "audio/wav

外一点就是，cgi程序输出HTML页面的方式都是使用printf把页面一行一行地打印出来，比如cgictest.c中的这一段代码：
fprintf(cgiOut, "<textarea NAME="address" ROWS=4 COLS=40> ");
fprintf(cgiOut, "Default contents go here. ");
fprintf(cgiOut, "</textarea> ");
上面这段代码的运行结果就是在页面上输出一个textarea。第一个参数cgiOut实际上就是stdin，所以我们可以直接使用printf，而不必使用fprintf。不过在调试的时候会用到fprintf来重定向输出

CGI 调试起来比较麻烦，CGIC提供了一个函数可以将环境变量输入到文件，方便调试。

[cpp] view plain copy

print ?

cgiWriteEnvironment("/etc/conf.d/c0/capcgi.dat");