下面是一个简单的CGI程序,它将HTML中Form的信息直接输出到We b浏览器。 # include # include main() { int i , n ; PRintf (″Content type: text/plain/n/n″); n=0; if(getenv(″CONTENT-LENGTH″)) n=atoi(getenv(CONTENT-LENGTH″)); for (i=0;i putchar(getchar()); putchar (′/n′); fflush(stdout); }
下面对此程序作一下简要的分析。 prinft (″Content type :text/plain/n/n″); 此行通过标准输出将字符串″Content type :text/plain/n/n″传送给Web服务器。它是一个MIME头信息,它告诉Web服务器随后的输出是以纯ASCII文本的形式。请注重在这个头信息中有两个新行符,这是因为Web服务器需要在实际的文本信息开始之前先看见一个空行。 if (getenv(″CONTENT-LENGTH″)) n=atoi (getenv(″CONTENT-LENGTH″)); 此行首先检查环境变量CONTENT-LENGTH是否存在。Web服务器在调用使用POST方法的CGI程序时设置此环境变量,它的文本值表示Web服务器传送给CGI程序的输入中的字符数目,因此我们使用函数atoi() 将此环境变量的值转换成整数,并赋给变量n。请注重Web服务器并不以文件结束符来终止它的输出,所以假如不检查环境变量CONTENT-LENGTH,CGI程序就无法知道什么时候输入结束了。 for (i=0;i putchar(getchar()); 此行从0循环到(CONTENT-LENGTH-1)次将标准输入中读到的每一个字符直接拷贝到标准输出,也就是将所有的输入以ASCII的形式回送给Web服务器。 通过此例,我们可将CGI程序的一般工作过程总结为如下几点。 1.通过检查环境变量CONTENT-LENGTH,确定有多少输入; 2.循环使用getchar()或者其他文件读函数得到所有的输入; 3.以相应的方法处理输入; 4.通过″Contenttype:″头信息,将输出信息的格式告诉Web服务器; 5.通过使用printf()或者putchar()或者其他的文件写函数,将输出传送给Web服务器。 总之,CGI程序的主要任务就是从Web服务器得到输入信息,进行处理,然后将输出结果再送回给Web服务器。
三、From输入的分析和解码 1.分析名字/值对 当用户提交一个HTML Form时,Web浏览器首先对Form中的数据以名字/值对的形式进行编码,并发送给Web服务器,然后由Web服务器传递给CGI程序。 其格式如下: name1=value1&name2=value2&name3=value3&name4=value4&... 其中名字是Form中定义的INPUT、SELECT或TEXTAREA等标置(Tag)名字,值是用户输入或选择的标置值。这种格式即为URL编码,程序中需要对其进行分析和解码。要分析这种数据流,CGI程序必须首先将数据流分解成一组组的名字/值对。这可以通过在输入流中查找下面的两个字符来完成。 每当找到字符=,标志着一个Form变量名字的结束;每当找到字符& ,标志着一个Form变量值的结束。请注重输入数据的最后一个变量的值不以&结束。 一旦名字/值对分解后,还必须将输入中的一些非凡字符转换成相应的ASCII字符。这些非凡字符是: +:将+转换成空格符; %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 当发现字符为&时,意味着一个名字/值对的结束,程序输出一个空行;当发现字符为+时,将它转换成空格; 当发现字符为%时,意味着一个两字符的十六进制值的开始,调用htoi()函数将随后的两个字符转换为相应的ASCII字符;当发现字符为=时,意味着一个名字/值对的名字部分的结束,并将它转换成字符:。最后将转换后的字符输出给Web服务器。 四、产生HTML输出 CGI程序产生的输出由两部分组成:MIME头信息和实际的信息。两部分之间以一个空行分开。我们已经看到怎样使用MIME头信息″Content type :text/plain/n/n″和printf()、put char()等函数调用来输 出纯ASCII文本给Web服务器。实际上,我们也可以使用MIME头信息″Content type :text/html/n/n″来输出HTML源代码给Web服务器。请注重任何MIME头信息后必须有一个空行。一旦发送这个MIME头信息给We b服务器后,Web浏览器将认为随后的文本输出为HTML源代码,在HTML源代码中可以使用任何HTML结构,如超链、图像、Form,及对其他CGI程 序的调用。也就是说,我们可以在CGI程序中动态产生HTML源代码输出 ,下面是一个简单的例子。 #include #include main() { printf(″Contenttype:text/html/n/n″); printf(″<html>/n″); printf(″<head><title>An HTML Page From a CGI</title></head>/n″); printf(″<body><br>/n″); printf(″<h2> This is an HTML page generated from with i n a CGI program.. .</h2>/n″); printf(″<hr><p>/n″); printf(″<a href="../output.html#two"><b> Go back to output.html page </b></a>/n″); printf(″</body>/n″); printf(″</html>/n″); fflush(stdout); } 上面的CGI程序简单地用printf()函数来产生HTML源代码。请注重在输出的字符串中假如有双引号,在其前面必须有一个后斜字符/, 这是因为整个HTML代码串已经在双引号内,所以HTML代码串中的双引号符必须用一个后斜字符/来转义。 五、结束语 本文具体分析了用C语言进行CGI程序设计的方法、过程和技巧。C语言的CGI程序虽然执行速度快、可靠性高,但是相对于Perl语言来说,C语言缺乏强有力的字符串处理能力,因此在实际应用中,应根据需 要和个人爱好来选择合适的CGI程序设计语言。