如何编写CGI程序

CGI的工作原理介绍：CGI（Common Gateway Interface）是一个WEB服务器提供信息服务的标准接口，通过这样一个接口，WEB服务器能够执行程序，并将程序输出的信息返回给浏览器。因为在WEB网上的数据都是静态的，通过CGI程序能够动态的处理浏览者的请求，如保存用户输入的信息，根据用户信息返回相关的资料等等。当客户端发送一个CGI请求给WEB服务器后，WEB服务器将根据CGI程序的类型决定数据向CGI程序的传送方式，一般来讲是通过标准输入/输出流和环境变量来与CGI程序间传递数据。   CGI的输入/输出方法：CGI程序通过标准输入（STDIN）和标准输出（STDOUT）来进行输入输出，STDIN和STDOUT是两个预先定义好的文件指针。你可以利用文件读写函数来对其进行操纵。 此外CGI程序还通过环境变量来得到输入，只不过环境变量中提供的是一些常用的信息，并且通常不包括用户在WEB页面中输入的信息（除使用下面讲的GET方法时，通过检查环境变量QUERY_STRING来得到输入数据），而STDIN通常用来传递用户输入的信息。在普通CGI程序开发中我们需要关心的环境变量有以下这些： 一部分是与WEB服务器有关的环境变量： SERVER_NAME WEB服务器名称 SERVER_PORT WEB服务器监听地址 SERVER_PROTOCOL 用于发送请求的协议名称和版本 SERVER_SOFTWARE WEB服务器名称和版本 一部分是与运行CGI有关的： REQUEST_METHOD 数据传送（信息传递）方法 CONTENT_LENGTH 数据长度 QUERY_STRING 所传送的数据 REMOTE_ADDR 客户方IP地址 REMOTE_HOST 客户方主机名程 一部分是与客户方有关的： HTTP_USER_AGENT 客户浏览器名称 HTTP_ACCEPT 客户机所能支持的MIME类型列表 HTTP_REFERER 客户机中前一文档的URL 在输入时所使用的POST/GET方法：在WEB页面向CGI发送数据时通常采用两种方法：GET/POST，GET方法将数据附加在URL后发送，如：/cgi/a_cgi_test.exe?your_data，CGI程序通过检查环境变量QUERY_STRING来得到输入数据。而POST方法则会将数据送入CGI程序的STDIN输入流。在表单（FORM）中的各个变量都会成为name=value的形式向WEB服务器发送，多个数据间用&分隔，如：name=value&name2=value2。其中名字（name，name2）是Form中定义的INPUT、SELECT或TEXTAREA等标置(Tag)名字,值是用户输入或选择的标置值。 有了上面的知识我们就可以马上写一个简单的CGI程序了。代码如下： void main(void) {// 本程序将用户输入的数据打印出来 fprintf(stdout,"content-type: text/plain\n\n"); // 输出一个CGI标题，这行代码的意义后面会讲解 char *pszMethod; pszMethod = getenv("REQUEST_METHOD"); if(strncmp(pszMethod,"GET") == 0) {// GET method //读取环境变量来获取数据 fprintf(stdout,"input data is :\n%s",getenv("QUERY_STRING")); } else {// POST method //读取STDIN来获取数据 int iLength=atoi(getenv("CONTENT_LENGTH")); fprintf(stdout,"input data is :\n"); for(int i=0;i<iLength;i++) { char cGet=fgetchar(stdin); fputchar(stdout,cGet); } } } 如上面说讲，在CGI程序输出时必须先输出一个CGI标题，标题共有以下三类： Location: 标题，指明输出另一个文档的URL，例如 fprintf(stdout,"Location: http://www.vchelp.net/\n\n"); Content-Type: 标题，指明发送的数据的MIME类型，例如 fprintf(stdout,"Content-Type: text/html\n\n"); Status: 标题，指明HTTP状态码，例如 fprintf(stdout,"Status: 200\n\n"); 注意每种标题后都必须跟一个换行和一个空行。 MIME类型以类型/子类型的形式来表示，下面是一些常用的类型/子类型的组合： Text/plain 普通文本类型 Text/html HTML格式的文本类型 Audio/basic 八位声音文件格式，后缀为.au Video/mpeg MPEG文件格式 Video/quicktime QuickTime文件格式 Image/gif GIF图形文件 Image/jpeg JPEG图形文件 Image/x-xbitmap X bitmap图形文件，后缀为.xbm 有了上面的知识我们就可以写出一些CGI程序，首先需要对输入数据进行分析，方法为：每当找到字符=,标志着一个Form变量名字的结束;每当找到字符& ,标志着一个Form变量值的结束。请注意输入数据的最后一个变量的值不以&结束。这样我们可以将输入数据分解为一组一组的指。 但随后会发现CGI的输入并不规则，例如有时会出现类似下面格式的输入字符号串：filename=hello&cmd=world+I%27，这是因为浏览器对一些上传的特殊字符进行了编码，所以在将数据分解开后需要进行解码，解码规则为：+:将+转换成空格符;%xx:用其十六进制ASCII码值表示的特殊字符（%做为转意符）。根据值xx将其转换成相应的ASCII字符。对Form变量名和变量值都要进行这种转换。下面是一个对Form数据进行分析并将结果回送给Web服务器的CGI程序。 　　#include 　　#include 　　#include 　　int htoi(char *); 　　main() 　　{ 　　　int i,n; 　　char c; 　　printf (″Contenttype: text/plain\n\n″); 　　n=0; 　　if (getenv(″CONTENT-LENGTH″)) 　　　n=atoi(getenv(″CONTENT-LENGTH″)); 　　for (i=0; i<n;i++){ 　　　int is-eq=0; 　　c=getchar(); 　　switch (c){ 　　　case ′&′: 　　　　c=′\n′; 　　　　break; 　　　case ′+′: 　　　　c=′　′; 　　　　break; 　　　case ′%′:{ 　　　　char s[3]; 　　　　s[0]=getchar(); 　　　　s[1]=getchar(); 　　　　s[2]=0; 　　　　c=htoi(s); 　　　　i+=2; 　　　} 　　　break; 　　case ′=′: 　　　c=′:′; 　　　is-eq=1; 　　　break; 　　}; 　　putchar(c); 　　if (is-eq) putchar(′　′); 　　} 　　putchar (′\n′); 　　fflush(stdout); 　　} 　　/* convert hex string to int */ 　　int htoi(char *s) 　　{ 　　　char *digits=″0123456789ABCDEF″; 　　if (islower (s[0])) s[0]=toupper(s[0]); 　　if (islower (s[1])) s[1]=toupper(s[1]); 　　return 16 * (strchr(digits, s[0]) -strchr (digits,′0′)) 　　 +(strchr(digits,s[1])-strchr(digits,′0′)); 　　} 上面的程序首先输出一个MIME头信息给Web服务器,检查输入中的字符数,并循环检查每一个字符。当发现字符为&时,意味着一个名字/值对的结束,程序输出一个空行;当发现字符为+时,将它转换成空格; 当发现字符为%时,意味着一个两字符的十六进制值的开始,调用htoi()函数将随后的两个字符转换为相应的ASCII字符;当发现字符为=时,意味着一个名字/值对的名字部分的结束,并将它转换成字符:。最后将转换后的字符输出给Web服务器。 开发CGI程序可以按照下面的步骤进行： 1、判断数据输入方法为GET或是POST。 2、读取数据，根据分隔符号&分解每个接收的表单变量，并同时对数据进行解码。 3、处理数据。 4、输出CGI标题，输出HTML数据。 5、退出。 利用C语言开发CGI需要自己对输入的数据进行分析，但字符号串处理并非C语言的强项，所以我向大家推荐一套我认为比较不错的开发包CGIC