【原创】CGIC库的移植及使用
【原创】CGIC库的移植及使用
一、CGIC库介绍
CGIC是一个支持CGI开发的开放源码的标准C库，可以免费使用，只需要在开发的站点和程序文档中有个公开声明即可，表明程序使用了CGIC库，用户也可以购买商业授权而无需公开声明。
CGIC能够提供以下功能：
- 分析数据，并自动校正一些有缺陷的浏览器发来的数据；
- 透明接收用GET或 POST方法发来的From数据；
- 能接受上传文件；
- 能够设置和接收cookies；
- 用一致的方式处理From元素里的回车；
- 提供字符串，整数，浮点数，单选或多选功能来接收数据；
- 提供数字字段的边界检查；
- 能够将CGI环境变量转化成C中的非空字符串；
- 提供CGI程序的调试手段，能够回放CGI程序执行时的CGI状态；
总之，CGIC是一个功能比较强大的支持CGI开发的标准C库，并支持Linux, Unix 和Windows等多操作系统。
二、CGIC移植
CGIC源码下载,版本是2.05版。将其解压并进入源码目录
# tar xzf cgic205.tar.gz
# cd cgic205修改Makefile文件:
找到CC=gcc，将其改成CC=arm-linux-gcc，
找到AR=ar，将其改成AR=arm-linux-ar，
找到RANLIB=ranlib，将其改成RANLIB=arm-linux-ranlib。
找到gcc cgictest.o -o cgictest.cgi ${LIBS}，将其改成$(CC) $(CFLAGS) cgictest.o -o cgictest.cgi ${LIBS}，
找到gcc capture.o -o capture ${LIBS}，将其改成$(CC) $(CFLAGS) capture.o -o capture ${LIBS}，并保存退出。然后运行make进行编译，编译后得到的CGIC库libcgic.a（该库在需要编写cgi接口程序时调用使用）以及CGI库的测试程序capture与cgictest.cgi，这两个测试程序仅用来演示CGIC库如何使用，为此，我们将capture和cgictest.cgi拷贝到目标主机的/var/www/cgi-bin目录下。
在pc端的浏览器地址栏输入http://192.168.0.10/cgi-bin/cgictest.cgi，可以看到页面，表示CGIC库和测试脚本都移植成功（运行前确保boa 服务器已经正常运行！）。cgictest.cgi比较完整的展现了CGIC库的功能，在开发基于CGIC库的CGI程序前最好先掌握cgictest.cgi程序，也是用户开发特定应用程序时的参考范例。
最终的运行结果见下图：
三、CGI程序的开发
CGI程序的工作一般就是接收表单数据，根据应用需求进行数据处理，最后根据处理结果生成新的页面返回给浏览器。表单数据一般是以POST方法提交给服务器，由CGI程序获得，程序根据元素名字/值中的元素名字来区分数据，完成数据处理后，再读取相应的模板文件，根据注释标记将对应的数据填充到HTML文本中去，生成最后的页面返回给浏览器。
程序一般逻辑为：
1、安全性检查，是否允许运行脚本；
2、处理用户提交的数据，根据元素名字/值中的元素名字来区分数据，然后根据应用需求进行数据处理；
3、将处理结果填充表单，根据注释标记将对应的数据填充到HTML文本中去，生成最后的页面返回给浏览器。
使用CGIC的基本思路：
对于使用CGIC编写的CGI程序，都是从cgic.c中的代码进入，在库函数完成了一系列必要的操作（比如解析参数、获取系统环境变量）之后，它才会调用你的代码（从你定义的cgiMain进入）。
cgi程序输出HTML页面的方式都是使用printf把页面一行一行地打印出来，比如cgictest.c中的这一段代码：
fprintf(cgiOut, "<textarea NAME=\"address\" ROWS=4 COLS=40>\n");
fprintf(cgiOut, "Default contents go here. \n");
fprintf(cgiOut, "</textarea>\n");上面这段代码的运行结果就是在页面上输出一个textarea。 第一个参数cgiOut实际上就是stdin，所以我们可以直接使用printf，而不必使用fprintf。不过在调试的时候会用到fprintf来重定向输出。
这种方式与Java Servlet非常类似，Servlet也是通过调用打印语句System.out.println(…)来输出一个页面。（不过后来Java推出了JSP来克服这种不便。）
但是与Servlet不同的地方在于，使用C语言的我们还要自己输出HTML头部（声明文档类型）：
cgiHeaderContentType(“text/html”);
这个语句的调用一定要在所有printf语句之前。而这个语句执行的任务实际上就是：
void cgiHeaderContentType(char *mimeType)
{
fprintf(cgiOut, "Content-type: %s\r\n\r\n", mimeType);
}这个语句告诉浏览器，这次传来的数据是什么类型，是一个HTML文档，还是一个bin文件… 如果是个HTML文档，就通过浏览器窗口显示，如果是一个bin（二进制）文件，则打开下载窗口，让用户选择是否保存文件以及保存文件的路径。
理解了这几点之后，你就可以编写自己的CGIC程序了。
//test.c
#include <stdio.h>
#include "cgic.h"
#include <string.h>
#include <stdlib.h>
int cgiMain()
{
cgiHeaderContentType("text/html");
fprintf(cgiOut, "<HTML><HEAD>\n");
fprintf(cgiOut, "<TITLE>My First CGI</TITLE></HEAD>\n");
fprintf(cgiOut, "<BODY><H1>Hello CGIC</H1></BODY>\n");
fprintf(cgiOut, "</HTML>\n");
return 0;
}编译程序并下载到开发板中的/var/www/cgi-bin目录，此时通过浏览器访问，会在页面上看到一个大大的“Hello CGIC”。