下载回源码包以后,就3个文件:
首先在vc6里创建一个空的win32静态库cgic,然后添加cgic.c,编译后得到cgic.lib库
int cgiMain() {
Captured \n");Captured \n");可以看到capture.c实在是太简单了,主函数main被定义在了cgic.c里,在主函数的最后调用了cgiMain(),所有我们要开发一个自己的cgi的话,
网上看到一篇中译版的,转过来附在后面
cgic: 为C语言编写CGI的C函数库
CGIC介绍
一般的UNIX系统都支持ANSIC,增加相应的库函数(和相应的h文件)就可以实现CGI。在此我向大家推荐一个用于CGI编程的ANSIC库:cgic。
cgic是用来生成基于CGI的WWW应用程序的C语言函数库,它有以下功能:
*对数据进行语法分析
*接收以GET和PSOT两种方式发送的数据
*把FORM中的不同域连接成连续的串
*为检索FORM数据而提供字符串,整数,浮点以及单项和多项选择功能
*为数字字段提供边界检测
*把CGI环境变量加载到非空的C串中
*为调试而捕捉CGI状态
*提供相对安全的系统调用功能
用一般ANSI C或C++编译器就可以编译cgic程序,不过与通常C程序不同的是,用cgic写的源码其主函数是cgiMain(),而不是通常的main()。cgic的函数库会自动把cgiMain连接到相应的main()上去。
基本结构cgictest.c:
cgic test \n"): cgic test \n"); capture
重点:在cgiHeader函数组中， cgiHeaderContentType(), 在任何向浏览器输出之前被调用. 否则将出错或浏览器不能识别。 cgiOut
接着, cgiMain() 调用不同的函数.当函数结束后,将返回0
这个函数的功能就是取的并显示由用户输入的name .
cgiFormString 确保断航
处理单一Checkboxes输入
这个函数依靠 cgiFormCheckboxSingle() 确定单一的checkbox 被选择。 cgiFormCheckboxSingle() 接受checkbox名字的属性值，如果存在就返回 cgiFormSuccess，否则返回cgiFormNotFound 如果是多项checkboxes，就用 cgiFormCheckboxMultiple()和cgiFormStringMultiple() 函数.
依靠cgiFormDoubleBounded()得到数据.第一个数据是返回数据中输入域的名字。最后一个值是用户没有提交时的默认值。
在整数输入,cgiFormInteger 和 cgiFormIntegerBounded 可以利用. 这些函数的功能类似.
处理单一选择输入 HTML标签被用于向用户提供几个选择. Radio buttons 和checkboxes 椰油这样的用途，大门、能够选择的数量很小时. Color()
void Color() {
这个函数确定用户选择了几个选项从 在表但的列表. cgiFormSelectSingle()
radio button也可以用这个函数.另外还有 cgiFormRadio(), 也是一样的
void NonExButtons() {
char **responses;
/* Method #1: check for valid votes. This is a good idea,
since votes for nonexistent candidates should probably
be discounted... */
fprintf(cgiOut, "Votes (method 1):
\n");
result = cgiFormCheckboxMultiple("vote", votes, 4,
voteChoices, &invalid);
if (result == cgiFormNotFound) {
fprintf(cgiOut, "I hate them all!
\n");
\n"); %s\n", votes[i]); \n");
}
参考cgiFormCheckboxMultiple(), cgiFormSelectMultiple().
NonExButtons() 函数在 cgictest.c:
/* Method #2: get all the names voted for and trust them.
This is good if the form will change more often
than the code and invented responses are not a danger
or can be checked in some other way. */
fprintf(cgiOut, "Votes (method 2):
\n");
result = cgiFormStringMultiple("vote", &responses);
if (result == cgiFormNotFound) {
fprintf(cgiOut, "I hate them all!
\n");
\n"); %s\n", responses[i]); \n");
}
/* We must be sure to free the string array or a memory
leak will occur. Simply calling free() would free
the array but not the individual strings. The
function cGIStringArrayFree() does the job completely. */
cgiStringArrayFree(responses);
}
参考cgiFormStringMultiple()
/* An array of strings; each C string is an array of characters */
cgiFormStringMultiple("vote", &responses);
检查CGI环境变量
#include "cgic.h"
char *colors[] = {
#define colorsTotal 3
int cgiMain() {
为调试而捕捉CGI状态
cgiFormResultType cgiFormStringNoNewlines( char *name, char *result, int max)
cgiFormResultType cgiFormStringSpaceNeeded( char *name, int *length)
cgiFormResultType cgiFormStringMultiple( char *name, char ***ptrToStringArray)
void cgiStringArrayFree(char **stringArray)
cgiFormResultType cgiFormInteger( char *name, int *result, int defaultV)
cgiFormResultType cgiFormIntegerBounded( char *name, int *result, int min, int max, int defaultV)
cgiFormResultType cgiFormDouble( char *name, double *result, double defaultV)
cgiFormResultType cgiFormDoubleBounded( char *name, double *result, double min, double max, double defaultV)
cgiFormResultType cgiFormSelectSingle( char *name, char **choicesText, int choicesTotal, int *result, int defaultV)
cgiFormResultType cgiFormCheckboxSingle( char *name)
cgiFormResultType cgiFormCheckboxMultiple( char *name, char **valuesText, int valuesTotal, int *result, int *invalid)
cgiFormResultType cgiFormRadio( char *name, char **valuesText, int valuesTotal, int *result, int defaultV)
void cgiHeaderLocation(char *redirectUrl)
void cgiHeaderStatus(int status, char *statusMessage)
void cgiHeaderContentType(char *mimeType)
cgiEnvironmentResultType cgiWriteEnvironment(char *filename)
cgiEnvironmentResultType cgiReadEnvironment(char *filename)
int cgiMain()
char *cgiServerSoftware
cgiFormSuccess
=========================================================================
CGIC简明教程
本系列的目的是演示如何使用C语言的CGI库“CGIC”完成Web开发的各种要求。
基础知识
C语言编程是一项复杂且容易出错的工作，所以在完成复杂任务时，一定要选择合适的库。对于用C语言编写CGI程序则更是如此。
本文纲要 ：
从上面提供的官方网址下载了CGIC库之后，解开压缩包，里面有大约10个文件，有用的是：
在开始编写你自己的CGI程序之前，一定要先走通他的例子程序，免得后来程序出错的时候还不知道是配置有问题，还是你的程序代码有问题。
1. test.cgi:cgictest.c cgic.h cgic.c
需要提醒的是，第二行开头一定是一个tab键（且仅有一个），不能使用空格。
我们看到，当前目录下应该多了一个test.cgi文件。
在你的网站根目录下建立一个cgi-bin目录（当然名字可以任意取，但作为习惯，一般叫做cgi-bin），然后在Apache的配置文件里赋予其执行CGI代码的权限，权限修改完之后要重启Apache。完成之后，把刚才生成的test.cgi放到cgi-bin目录中。此时我们可以在浏览器中输入以下地址进行访问：
如果正常的话，应该看到一个网页被展示出来。这样，第一个C语言的CGI程序就运行起来了。
从cgic.c的代码可以看出，它定义了main函数，而在cgictest.c中定义了一个cgiMain函数。也就是说，对于使用CGIC编写的CGI程序，都是从cgic.c中的代码进入，在库函数完成了一系列必要的操作（比如解析参数、获取系统环境变量）之后，它才会调用你的代码（从你定义的cgiMain进入）。
另外一点就是，cgi程序输出HTML页面的方式都是使用printf把页面一行一行地打印出来，比如cgictest.c中的这一段代码：
上面这段代码的运行结果就是在页面上输出一个textarea。 第一个参数cgiOut实际上就是stdin，所以我们可以直接使用printf，而不必使用fprintf。不过在调试的时候会用到fprintf来重定向输出。
这个语句的调用一定要在所有printf语句之前。而这个语句执行的任务实际上就是：
这个语句告诉浏览器，这次传来的数据是什么类型，是一个HTML文档，还是一个bin文件… 如果是个HTML文档，就通过浏览器窗口显示，如果是一个bin（二进制）文件，则打开下载窗口，让用户选择是否保存文件以及保存文件的路径。
理解了这几点之后，你就可以编写自己的CGIC程序了。新建一个文件test.c试试：
1. #include My First CGI \n");Hello CGIC \n");
把Makefile文件中的cgitest.c全部换称test.c，保存，再执行make命令即可。
Get请求字符串就是跟在URL后面以问号“?”开始的字符串，但不包括问号。比如这样的一个请求：
在上面这个URL中，“ThisIsTheGetString”就是Get请求字符串。
在进入我们自己编写的cgi代码之前，CGIC库已经事先把这个字符串取到了，我们可以在程序中直接获得，要做的仅仅是在你编写的cgiMain方法前面加入以下声明：
现在给出一个简单的例子，这个例子跟上一篇的测试程序非常相似，只不过程序的输出是使用者输入的Get请求字符串。
1. #include My CGIC \n");%s ",cgiQueryString);
假设把这个程序编译成out.cgi（编译方法参见上一篇），并部署到Web服务器的cgi-bin目录下，当用户在浏览器地址栏输入本文开头给出的URL字符串时，浏览器页面上会显示：
我们也可以编写一个用于测试的HTML页面：
1.
Test 文件的部署结构应该为：
大家可以试试，通过浏览器访问，在文本框内输入一些字符，并点击提交按钮，然后就可以看到cgi程序的执行结果：把在文本框输入的字符原样显示在浏览器上。
CGIC简明教程3：反转义
浏览器在发送Get请求时，会把请求字符串进行转义操作（英文术语为: escape）； 比如，我们在地址栏输入（注意最后”it’s me”中的空格）:
浏览器会把它转义为：
你会发现，浏览器最终发送的请求为
通过CGIC，我们可以把这些被转义后的字符还原为我们本来的输入，这个过程就叫“反转义” (Unescape)。
整个过程分三个步骤：
注意，我们要找的只是这个函数声明，不是函数定义；
2）在这个函数声明语句的上方，你会看到一个结构体定义：
1. typedef enum {
把这几行语句复制到cgic.h文件中，并在这里把它注释掉；
3）我们现在就可以使用反转义函数cgiUnescapeChars了：
接下来我们给出一段完整的test.c代码
1. #include My CGI \n");%s ",buffer);
值得注意的是，buffer的存储空间是cgiUnescapeChars帮你分配的，但最后要由你自己来释放（free），这一点千万不可忘记。
下面你可以结合上一篇给出的测试用html代码试试该cgi程序的运行结果，也可以直接在浏览器地址栏输入一些带有特殊符号的字符串。
最后讲一下为什么不得不用这种hacker的方式来完成该任务，而CGIC不显式提供？
那么chat.cgi就会把“this is a cgi user”当做你对它说的话，经过处理，它会回复一段语句。为了方便，我们并没有写成“键－值”对的形式。这个时候被我们hack的cgiUnescapeChars就能派上用场了。
我们在提交一个表单(form)时，怎样把表单内的值提取出来呢？
当out.cgi收到请求时，需要把输入框”name”和输入框”number”内的值提取出来。而且不管form中的action是GET还是POST，都要有效。
下面给出示例代码：
1. #include My CGI \n");%s ",name);%s ",number);
从上面的代码可以看出，第13行和第14行获取了输入框的值。
获取输入参数值在CGIC中其实有一族函数，cgiFormString是其中最常用的一个。
不少网站都有文件上传的功能，本文展示如何用CGIC库编写文件上传的服务端程序，最后给出一段简单的HTML代码，供大家测试使用 。
1. #include
假设该文件存储为upload.c，则使用如下命令编辑：
编译完成后把upload.cgi复制到你部署cgi程序的目录（通常命名为cgi-bin）。
测试用HTML代码:
1.
最后的文件目录结构为
那么如何控制上传文件的大小呢？因为你有时会不允许用户上传太大的文件。
1. else if (cgiStrEqNc(cgiContentType, "multipart/form-data")) {
变量UpSize表示文件大小的上限。在cgic.c的main中找到相关代码，并修改成上面这样即可。你可以在cgic.c中定义UpSize，也可以在刚才完成的upload.c中定义，然后在cgic.c中用extern方式引用。
