六、CGI与HTML通信

1、CGI简介

cgi是一个接口
CGIC是一个支持CGI开发的开放源码的标准C库，可以免费使用，只需要在开发的站点和程序文档中有个公开声明即可，表明程序使用了CGIC库，用户也可以购买商业授权而无需公开声明。
CGIC能够提供以下功能：

1. 分析数据，并自动校正一些有缺陷的浏览器发来的数据；
2. 透明接收用GET或 POST方法发来的Form数据；
3. 能接受上传文件；
4. 能够设置和接收cookies；
5. 用一致的方式处理From元素里的回车；
6. 提供字符串，整数，浮点数，单选或多选功能来接收数据；
7. 提供数字字段的边界检查；
8. 能够将CGI环境变量转化成C中的非空字符串；
9. 提供CGI程序的调试手段，能够回放CGI程序执行时的CGI状态；
   总之，CGIC是一个功能比较强大的支持CGI开发的标准C库，并支持Linux, Unix 和Windows等多操作系统。

2、CGI的移植

1. 源码下载并解压
   下载地址http://www.boutell.com/cgic/下载源码将其解压并进入源码目录

   # tar xzf cgic205.tar.gz
   # cd cgic205
   

2. 搭建交叉编译环境

   修改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}，
   

   修改后的Makefile

   ​CFLAGS=-g -Wall
   #CROSS_COMPILE=
   CROSS_COMPILE=arm-linux-
   CC=$(CROSS_COMPILE)gcc
   AR=$(CROSS_COMPILE)ar
   RANLIB=$(CROSS_COMPILE)ranlib
   LIBS=-L./ -lcgic
   all: libcgic.a cgictest.cgi capture
   install: libcgic.a  //可以执行 make install 命令 目标
   	cp libcgic.a /usr/local/lib
   	cp cgic.h /usr/local/include
   	@echo libcgic.a is in /usr/local/lib. cgic.h is in /usr/local/include.
   libcgic.a: cgic.o cgic.h //libcgic.a 依赖于 cgic.c 和 cgic.h 
   	rm -f libcgic.a
   	$(AR) rc libcgic.a cgic.o //一个归档命令 ar rc libcgic.a 
   	$(RANLIB) libcgic.a //“ranlib”来对静态库的符号索引表进行更新。 
   #mingw32 and cygwin users: replace .cgi with .exe
   cgictest.cgi: cgictest.o libcgic.a
   	$(CC) $(CFLAGS) cgictest.o -o cgictest.cgi ${LIBS}
   	#gcc cgictest.o -o cgictest.cgi ${LIBS}
   capture: capture.o libcgic.a
   	$(CC) $(CFLAGS) capture.o -o capture ${LIBS}
   	#gcc capture.o -o capture ${LIBS}
   clean:
   	rm -f *.o *.a cgictest.cgi capture
   

3、CGI文件分析

/cgic205$ ls
capture.c  cgic.h     cgictest.c   Makefile  mytest.cgi  support.txt
cgic.c     cgic.html  license.txt  mytest.c  readme.txt

cgic.h：头文件；
cgic.c：CGIC的源代码文件；
cgictest.c：CGIC库的作者提供的一个CGI程序例子；
capture.c：用于调试CGI程序的工具；
Makefile：安装CGIC的脚本文件；

把CGIC安装为操作系统的一个动态链接库，这样我们每次编译的时候，就不需要有cgic.c这个源文件了。但是由于需要（以后将会看到），我们将修改cgic.c代码，所以我们不把它安装进系统。每次编译的时候，只要把cgic.c和cgic.h放到当前文件夹就好了。

4.make编译源码

得到的CGIC库libcgic.a
我们通过调试辅助程序capture和测试程序cgictest.cgi，来验证生成CGIC库的正确性。
将capture和cgictest.cgi拷贝到主机的/rootfs/boa/cgi-bin目录下
cp capture cgictest.cgi /home/.../rootfs/boa/cgi-bin
cp libcgic.a /home/.../rootfs/lib

5、测试安装

我们用他自带cgictest.c来实现自己的第一个C语言CGI程序。

1. 先运行boa服务器(后台运行)
   ./boa &

2. 在工作站的浏览器地址栏输入http://192.168.1.100/cgi-bin/cgictest.cgi， （直接指定要运行的程序）、（指定网页运行举例：http://192.168.1.100/pass.html 板子ip/网页名）

3. 如果可以看到页面，表示CGIC库和测试脚本都移植成功。cgictest.cgi比较完整的展现了CGIC库的功能，在开发基于CGIC库的CGI程序前最好先掌握cgictest.cgi程序，这个应用程序是十分重要的参考范例。

6、项目程序框架

7、扩展

7.1、CGI程序的工作流程

1. 接收表单数据，根据应用需求进行数据处理，最后根据处理结果生成新的页面返回给浏览器。
2. 表单数据一般是以POST方法提交给服务器，由CGI程序获得，程序根据元素名字/值中的元素名字来区分数据，
3. 完成数据处理后，再读取相应的模板文件，根据注释标记将对应的数据填充到HTML文本中去，生成最后的页面返回给浏览器。

mytest.c——> Makefile 中添加相关编译信息—–>执行make—–>生成mytest.cgi

7.2、HTML模板的制作–CGIC的基本思路

从cgic.c的代码可以看出，它定义了main函数，而在cgictest.c中定义了一个cgiMain函数。
也就是说，对于使用CGIC编写的CGI程序，都是从cgic.c中的代码进入，在库函数完成了一系列必要的操作（比如解析参数、获取系统环境变量）之后， 它才会调用你的代码（从你定义的cgiMain进入）。
另外一点就是，cgi程序输出HTML页面的方式都是使用printf把页面一行一行地打印出来，比如cgictest.c中的这一段代码：

 fprintf(cgiOut, "<textarea NAME=\"address\" ROWS=4 COLS=40>\n"); //cgiOut实际上就是stdin
 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（二进制）文件，则打开下载窗口，让用户选择是否保存文件以及保存文件的路径。