CGIC简明教程目录(CGI篇)

CGIC简明教程目录(CGI篇)CGIC简明教程目录本系列的目的是演示如何使用C语言的CGI库“CGIC”完成Web开发的各种要求。基础知识*1:使用CGIC的基本思路*2:获取Get请求字符串*3:反转义*4:获取请求中的参数值进阶训练*用CGIC实现文件上传CGIC简明教程1：使用CGIC的基本思路C语言编程是一项复杂且容易出错的工作，所以在完成复杂任务时，一定要选择合适的库。对于用C语言编写CGI程序则更是如此。CGIC是非常优秀的C语言CGI库函数。其下载地址为：，现在的版本号是2.05。本站从今天开始，将逐步介绍如何使用CGIC完成各种操作，也可以说是一个Tutorial。（注：本系列涉及的编程环境都是Linux，Windows用户需要对用到的操作系统命令稍作修改）本文纲要：CGIC的安装、测试安装、使用CGIC的基本思路；1)CGIC的下载安装从上面提供的官方网址下载了CGIC库之后，解开压缩包，里面有大约10个文件，有用的是：cgic.h：头文件；cgic.c：CGIC的源代码文件；cgictest.c：CGIC库的作者提供的一个CGI程序例子；capture.c：用于调试CGI程序的工具；Makefile：安装CGIC的脚本文件；可以看到，整个库实际上就是cgic.c一个文件，可以说是非常的精炼。我们可以把CGIC安装为操作系统的一个动态链接库，这样我们每次编译的时候，就不需要有cgic.c这个源文件了。但是由于需要（以后将会看到），我们将修改cgic.c代码，所以我们不把它安装进系统。每次编译的时候，只要把cgic.c和cgic.h放到当前文件夹就好了。2)测试安装在开始编写你自己的CGI程序之前，一定要先走通他的例子程序，免得后来程序出错的时候还不知道是配置有问题，还是你的程序代码有问题。我们用他自带cgictest.c来实现自己的第一个C语言CGI程序。你可以新建一个工作目录，用于存放你的CGI程序源代码，把cgic.h,cgic.c,cgictest.c三个文件拷贝到这个目录，然后建立一个Makefile文件，其内容为：1.test.cgi:cgictest.ccgic.hcgic.c2.gcc-wallcgictest.ccgic.c-otest.cgi需要提醒的是，第二行开头一定是一个tab键（且仅有一个），不能使用空格。保存好Makefile的内容之后，执行make命令：make我们看到，当前目录下应该多了一个test.cgi文件。在你的网站根目录下建立一个cgi-bin目录（当然名字可以任意取，但作为习惯，一般叫做cgi-bin），然后在Apache的配置文件里赋予其执行CGI代码的权限，权限修改完之后要重启Apache。完成之后，把刚才生成的test.cgi放到cgi-bin目录中。此时我们可以在浏览器中输入以下地址进行访问：如果正常的话，应该看到一个网页被展示出来。这样，第一个C语言的CGI程序就运行起来了。如果浏览器报错，那么多半是配置Apache的时候有些操作没有正确完成。3)使用CGIC的基本思路从cgic.c的代码可以看出，它定义了main函数，而在cgictest.c中定义了一个cgiMain函数。也就是说，对于使用CGIC编写的CGI程序，都是从cgic.c中的代码进入，在库函数完成了一系列必要的操作（比如解析参数、获取系统环境变量）之后，它才会调用你的代码（从你定义的cgiMain进入）。另外一点就是，cgi程序输出HTML页面的方式都是使用printf把页面一行一行地打印出来，比如cgictest.c中的这一段代码：fprintf(cgiOut,textareaNAME=\address\ROWS=4COLS=40\n);fprintf(cgiOut,Defaultcontentsgohere.\n);fprintf(cgiOut,/textarea\n);上面这段代码的运行结果就是在页面上输出一个textarea。第一个参数cgiOut实际上就是stdin，所以我们可以直接使用printf，而不必使用fprintf。不过在调试的时候会用到fprintf来重定向输出。这种方式与JavaServlet非常类似，Servlet也是通过调用打印语句System.out.println(…)来输出一个页面。（不过后来Java推出了JSP来克服这种不便。）但是与Servlet不同的地方在于，使用C语言的我们还要自己输出HTML头部（声明文档类型）：cgiHeaderContentType(text/html);这个语句的调用一定要在所有printf语句之前。而这个语句执行的任务实际上就是：voidcgiHeaderContentType(char*mimeType){fprintf(cgiOut,Content-type:%s\r\n\r\n,mimeType);}这个语句告诉浏览器，这次传来的数据是什么类型，是一个HTML文档，还是一个bin文件…如果是个HTML文档，就通过浏览器窗口显示，如果是一个bin（二进制）文件，则打开下载窗口，让用户选择是否保存文件以及保存文件的路径。理解了这几点之后，你就可以编写自己的CGIC程序了。新建一个文件test.c试试：下载:test.c1.#includestdio.h2.#includecgic.h3.#includestring.h4.#includestdlib.h5.intcgiMain(){6.cgiHeaderContentType(text/html);7.fprintf(cgiOut,HTMLHEAD\n);8.fprintf(cgiOut,TITLEMyFirstCGI/TITLE/HEAD\n);9.fprintf(cgiOut,BODYH1HelloCGIC/H1/BODY\n);10.fprintf(cgiOut,/HTML\n);11.return0;12.}把Makefile文件中的cgitest.c全部换称test.c，保存，再执行make命令即可。此时通过浏览器访问，会在页面上看到一个大大的“HelloCGIC”。CGIC简明教程2：获取Get请求字符串Get请求就是我们在浏览器地址栏输入URL时发送请求的方式，或者我们在HTML中定义一个表单（form）时，把action属性设为“Get”时的工作方式；Get请求字符串就是跟在URL后面以问号“?”开始的字符串，但不包括问号。比如这样的一个请求：在上面这个URL中，“ThisIsTheGetString”就是Get请求字符串。在进入我们自己编写的cgi代码之前，CGIC库已经事先把这个字符串取到了，我们可以在程序中直接获得，要做的仅仅是在你编写的cgiMain方法前面加入以下声明：externchar*cgiQueryString;现在给出一个简单的例子，这个例子跟上一篇的测试程序非常相似，只不过程序的输出是使用者输入的Get请求字符串。下载:test.c1.#includestdio.h2.#includecgic.h3.#includestring.h4.#includestdlib.h5.6.externchar*cgiQueryString;7.intcgiMain(){8.cgiHeaderContentType(text/html);9.fprintf(cgiOut,HTMLHEAD\n);10.fprintf(cgiOut,TITLEMyCGIC/TITLE/HEAD\n);11.fprintf(cgiOut,BODY);12.fprintf(cgiOut,H1%s/H1,cgiQueryString);13.fprintf(cgiOut,/BODY\n);14.fprintf(cgiOut,/HTML\n);15.return0;16.}假设把这个程序编译成out.cgi（编译方法参见上一篇），并部署到Web服务器的cgi-bin目录下，当用户在浏览器地址栏输入本文开头给出的URL字符串时，浏览器页面上会显示：ThisIsTheGetString我们也可以编写一个用于测试的HTML页面：下载:test.html1.html2.head3.titleTest/title4./head5.body6.formaction=cgi-bin/out.cgimethod=get7.inputtype=textname=theText8.inputtype=submitvalue=Continue→9./form10./body11./html文件的部署结构应该为：|test.html|—-cgi-bin/out.cgi大家可以试试，通过浏览器访问，在文本框内输入一些字符，并点击提交按钮，然后就可以看到cgi程序的执行结果：把在文本框输入的字符原样显示在浏览器上。CGIC简明教程3：反转义浏览器在发送Get请求时，会把请求字符串进行转义操作（英文术语为:escape）；比如，我们在地址栏输入（注意最后”it’sme”中的空格）:~Jack/cgi-bin/out.cgi?it'sme浏览器会把它转义为：~Jack/cgi-bin/out.cgi?it's%20me在上一篇最后给出的例子中，如果在文本框内输入it'sme你会发现，浏览器最终发送的请求为~Jack/cgi-bin/out.cgi?theText=it%27s+me通过CGIC，我们可以把这些被转义后的字符还原为我们本来的输入，这个过程就叫“反转义”(Unescape)。不过这个过程有点像hack他的代码。整个过程分三个步骤：1）打开cgic.c，找到这一行语句：staticcgiUnescapeResultTypecgiUnescapeChars(char**sp,char*cp,intlen);注意，我们要找的只是这个函数声明，不是函数定义；2）在这个函数声明语句的上方，你会看到一个结构体定义：1.typedefenum{2.cgiUnescapeSuccess,3.cgiUnescapeMemory4.}cgiUnescapeResultType;把这几行语句复制到cgic.h文件中，并在这里把它注释掉；同时还要删除在第一步中找到的函数声明语句中的“static”关键字。3）我们现在就可以使用反转义函数cgiUnescapeChars了：在你自己的代码（按照惯例，还是test.c）中，加入以下声明语句即可externcgiUnescapeResultTypecgiUnescapeChars(char**sp,char*cp,intlen);接下来我们给出一段完整的test.c代码下载:test.c1.#includestdio.h2.#includecgic.h3.#includestring.h4.#includestdlib.h5.6.externchar*cgiQueryString;7.externcgiUnescapeResultTypecgiUnescapeChars(char**sp,char*cp,intlen);8.intcgiMain(){9.char*buffer;10.cgiHeaderContentType(text/html);11.fprintf(cgiOut,HTMLHEAD\n);