cgic中文文档：https://www.cnblogs.com/programmer-wfq/p/5582114.html
1.cgi通信方式
当有数据从客户端浏览器传到Web服务器后，web服务器会根据传送的类型（基本有二类：GET/POST），将接收到的数据传入 QUERY_STRING或变量中， CGI程序可以通过标准输入，在程序中接收web服务器接收的数据。当要向浏览器发送信息时，只要向Web服务器发送特定的文件头信息，即可通过标准输出将信息发往Web服务器， Web服务器处理完由CGI程序发来的信息后就会将信息发送给浏览器。
2.接收数据
用GET方式接收到的数据保存在Web服务器的QUERY_STRING 变量里，而通过POST方式接收到的数据是保存在Web服务器变量里。两种数据接收方式的区别是：以GET方式接收的数据是有长度限制，而用POST方式接收的数据是没有长度限制的；以GET方式发送数据，可以通过URL的形式来发送，但POST方式发送的数据必须要通过Form才发送。
3.CGI变量
char *cgiServerSoftware
服务器软件名称,或者一个空的字符串
char *cgiServerName
返回服务器名称或空
char *cgiGatewayInterface
网关接口(通常是 CGI/1.1)或空
char *cgiServerProtocol
网络协议(usually HTTP/1.0)或空
char *cgiServerPort
服务器端口(usually 80),或空
char *cgiRequestMethod
请求方式(usually GET or POST)或空
char *cgiPathInfo
指出附加虚拟路径
char *cgiPathTranslated
指出附加虚拟路径并由服务器转为本地路径
char *cgiscriptName
调用程序的名字
char *cgiQueryString
包含GET-method请求或者<ISINDEX> 标签。不需解析，除非用<ISINDEX>标签，通常由CGIC函数库自动解析。
char *cgiRemoteHost
从浏览器返回客户主机的名字
char *cgiRemoteAddr
从浏览器返回客户的IP地址
char *cgiAuthType
返回用户授权信息
char *cgiRemoteUser
鉴别用户cgiAuthType.
char *cgiRemoteIdent
返回用户的名字（用户通过用户坚定协议）
char *cgiContentType
返回MIME内型
char *cgiAccept
参考 cgiHeaderContentType() cgiUserAgent
char *cgiUserAgent
获取的用户浏览器信息
char *cgiReferrer
指向用户访问的URL.
int cgiContentLength
表单或查询数据的字节被认为是标准的.
FILE *cgiOut
CGI输出。cgiHeader函数,象cgiHeaderContentType，首先被用于输出mime头；用于 fprintf() 和fwrite()。cgiOut通常相当于stdout。
FILE *cgiIn
CGI输入
4.CGIC库主要函数
用一般 ANSI C或C++编译器就可以编译CGIC程序 , 与C程序不同的是，用CGIC写的源码其主函数是cgiMain(), 而不是通常的main。 CGIC的函数库会自动把cgiMain连接到相应的main上。
CGIC库主要函数说明：
cgiFormResultType cgiFormString( char *name, char *result, int max)
用于从输入域中copy字符串。将域名max-1字节中的字符copy到缓冲区result。若域不存在，则copy一个空串到result缓冲区。在此函数中所有的新行由换行符代表。
cgiFormResultType cgiFormStringNoNewlines( char *name, char *result, int max)
与cgiFormString函数相似，只是所有的CR和LF都被去掉。
cgiFormResultType cgiFormStringSpaceNeeded( char *name, int *length)
返回指向name的字符串的长度，并将长度放入length中。
cgiFormResultType cgiFormStringMultiple( char *name, char ***ptrToStringArray)
若同一名字有多个输入域，或域中的字符串可以动态变化，使用本函数。它把名为name的所有输入域的值放在prtToStringArray中。
void cgiStringArrayFree(char **stringArray)
释放了分配给stringArray的内存。
cgiFormResultType cgiFormInteger( char *name, int *result, int defaultV)
从输入域中取出整数放入result中。
cgiFormResultType cgiFormIntegerBounded( char *name, int *result, int min, int max, int defaultV)
若输入域中的整数在界限内则取出并放入result中。
cgiFormResultType cgiFormDouble( char *name, double *result, double defaultV)
从输入域中取出浮点数放入result中。
cgiFormResultType cgiFormDoubleBounded( char *name, double *result, double min, double max, double defaultV)
若输入域中的浮点数在界限内则取出并放入result中。
cgiFormResultType cgiFormSelectSingle( char *name, char **choicesText, int choicesTotal, int *result, int defaultV)
取出复选框(跟在select语句之后的)，把选择的名字copy到choicesText，把选择的个数copy到choicesTotal，把当前的选择copy到result。
cgiFormResultType cgiFormSelectMultiple( char *name, char **choicesText, int choicesTotal, int *result, int *invalid)
与cgiFormSelectSingle类似，只指向整型数组的result代表了选择的项。
cgiFormResultType cgiFormCheckboxSingle( char *name)
若复选框被选中，则函数返回cgiFormSuccess，否则返回cgiFormNotFound。
cgiFormResultType cgiFormCheckboxMultiple( char *name, char **valuesText, int valuesTotal, int *result, int *invalid)
与cgiFormCheckboxSingle类似，但它处理同一名字有多个复选框的情况。name指向复选框的名字；valuesText指向包含有每个复选框中参数的一个数组；valuesTotal指向复选框的总数；result是一个整型数组，每个复选框选中的用1代表，没选中的用0代表。
cgiFormResultType cgiFormRadio( char *name, char **valuesText, int valuesTotal, int *result, int defaultV)
与cgiFormCheckboxMultiple相似，只是这里是单选按钮而不是复选框。
void cgiHeaderLocation(char *redirectUrl)
重定向到redirectUrl指定的URL。
void cgiHeaderStatus(int status, char *statusMessage)
输出状态代码status和消息statusMessage。
void cgiHeaderContentType(char *mimeType)
用于告知浏览器返回的是什么类型的文档。在任何向浏览器输出之前被调用，否则将出错或浏览器不能识别。
cgiEnvironmentResultType cgiWriteEnvironment(char *filename)
本函数把当前CGI环境写入filename文件中以便以后调试时使用
cgiEnvironmentResultType cgiReadEnvironment(char *filename)
本函数从filename文件中读取CGI环境以便用来调试。
5.CGI结果编码
CGIC结果编码参考：
cgiFormSuccess 提交信息成功 cgiFormTruncated 删除部分字节. cgiFormBadType 错误的输入信息（没有按要求） cgiFormEmpty 提交信息为空. cgiFormNotFound 提交信息没有找到. cgiFormConstrained 数字属于某个特定的范围，被迫低于或高于适当范围。 cgiFormNoSuchChoice 单一选择提交的值是不被接受。通常说明表但和程序之间存在矛盾。 cgiEnvironmentIO 从CGI环境或获取的文件读或写的企图失败，报出I/O的错误。 cgiEnvironmentMemory 从CGI环境或获取的文件读或写的企图失败，报出out-of-memory的错误。 cgiEnvironmentSuccess 从CGI环境或获取的文件读或写的企图成功。
6.CGI环境变量
REQUEST_METHOD 请求类型，如“GET”或“POST” CONTENT_TYPE 被发送数据的类型 CONTENT_LENGTH 客户端向标准输入设备发送的数据长度，单位为字节 QUERY_STRING 查询参数，如“id=10010&sn=liigo” SCRIPT_NAMECGI 脚本程序名称 PATH_INFOCGI 脚本程序附加路径 PATH_TRANSLATEDPATH_INFO 对应的绝对路径 REMOTE_ADDR 发送此次请求的主机IP REMOTE_HOST 发送此次请求的主机名 REMOTE_USER 已被验证合法的用户名 REMOTE_IDENTWEB 服务器的登录用户名 AUTH_TYPE 验证类型 GATEWAY_INTERFACE 服务器遵守的CGI版本，如：CGI/1.1 SERVER_NAME 服务器主机名、域名或IP SERVER_PORT 服务器端口号 SERVER_PROTOCOL 服务器协议，如：HTTP/1.1 DOCUMENT_ROOT 文档根目录 SERVER_SOFTWARE 服务器软件的描述文本 HTTP_ACCEPT 客户端可以接收的MIME类型，以逗号分隔 HTTP_USER_AGENT 发送此次请求的web浏览器 HTTP_REFERER 调用此脚本程序的文档 HTTP_COOKIE 获取COOKIE键值对，多项之间以分号分隔，如：key1=value1;key2=value2
7.输出标头
cgiHeaderContentType，在任何向浏览器输出之前被调用 ，否则将出错或浏览器不能识别。
8.处理输入文本
void Name() {
char name[81];
cgiFormStringNoNewlines("name", name, 81);
fprintf(cgiOut, "Name: %s<BR>
", name);
}
9.处理单一复选框
void Hungry()
{
if (cgiFormCheckboxSingle("hungry") == cgiFormSuccess)
{
fprintf(cgiOut, "I'm Hungry!<BR>
");
}
else
{
fprintf(cgiOut, "I'm Not Hungry!<BR>
");
}
}
cgiFormCheckboxSingle接checkbox名字的属性值，如果存在就返回cgiFormSuccess，否则返回cgiFormNotFound。如果是多项checkboxes，就用cgiFormCheckboxMultiple和cgiFormStringMultiple函数。
10.处理数字输入
void Temperature()
{
double temperature;
cgiFormDoubleBounded("temperature", &temperature, 80.0, 120.0, 98.6);
fprintf(cgiOut, "My temperature is %f.<BR>
", temperature);
}
cgiFormDoubleBounded 返回的值被检查确信用户输入的资料在规定范围内， 而不是其他无效的数据。
11.处理单一选择输入
char *colors[] = {
"Red",
"Green",
"Blue"
};
void Color()
{
int colorChoice;
cgiFormSelectSingle("colors", colors, 3, &colorChoice, 0);
fprintf(cgiOut, "I am: %s<BR>
", colors[colorChoice]);
}
12.处理多项选择的输入
char *votes[] = { "A", "B", "C", "D" };
void NonExButtons()
{
int voteChoices[4];
int i; int result;
int invalid;
char **responses;
fprintf(cgiOut, "Votes (method 1):<BR>
");
result = cgiFormCheckboxMultiple("vote", votes, 4, voteChoices, &invalid);
if (result == cgiFormNotFound)
{
fprintf(cgiOut, "I hate them all!<p>
");
}
else
{
fprintf(cgiOut, "My preferred candidates are:
");
fprintf(cgiOut, "<ul>
");
for (i=0; (i < 4); i++)
{
if (voteChoices[i])
{
fprintf(cgiOut, "<li>%s
", votes[i]);
}
}
fprintf(cgiOut, "</ul>
");
}
}
13.处理表单GET
表单通常分为两个部分：HTML表单格式和处理数据的脚本，处理程序由标签的ACTION属性指定，每个输入区都有一个NAME属性用来称呼表单元素，当表单数据被递交给ACTION中定义的处理程序时，NAME和其输入内容被以数字或字符的形式保存在环境变量中，脚本程序再通过读取环境变量的方式获得用户输入，根据编程语言的不同获取环境变量的方式也不同，C语言中可以通过stdlib库函数getenv来获得环境变量。
表单从浏览器发给服务器有两种方法（METHOD属性）：GET和POST。GET方法将数据打包放在环境变量QUERY_STRING中作为URL整体的一部分传递给服务器。POST做很多类型GET的事情，但是它分离地传递数据给脚本的，程序要通过标准输入或得数据，POST方式不会改变数据，也就是说同样的数据可以多次提交而不必重新输入。当数据量超过1024时只能使用POST来传递，由于GET将数据直接放到URL中，数据的传输也就变得很不安全。
表单输入的数据通过URL编码后传输到服务器端，URL的编码规则如下：
A、每个name/value以name=valu的形式配对出现，每对name/valu之间用&分隔
B、若用户没有对某个name赋值，则以“name=”的形式出现
C、任何特殊字符以百分号%用十六进制编码。
D、输入区的空格将以“+”显示
要想得到用户输入的数据就必须对传递进来的URL编码进行解码，解码有很多工具可用，比如CGIC库中就已经对解码进行了包装，常用的工具还有uncgi。
14.实例
HTML网页制作：
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Test Upload</title>
<meta name="author" content="scorpio">
<!-- Date: 2016-07-30 -->
</head>
<body>
<form action="cgi-bin/upload.cgi" method="post" enctype="multipart/form-data" target="_blank">
<input type="file" name="file" value="" />
<input type="submit" name="submit" value="OK">
</form>
</body>
</html>
cgi程序编程：
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/stat.h>
#include "cgic.h"
#define BufferLen 1024
int cgiMain(void)
{
cgiFilePtr file;
int targetFile;
mode_t mode;
char name[128];
char fileNameOnServer[64];
char contentType[1024];
char buffer[BufferLen];
char *tmpStr=NULL;
int size;
int got,t;
cgiHeaderContentType("text/html");
//取得html页面中file元素的值，应该是文件在客户机上的路径名
if (cgiFormFileName("file", name, sizeof(name)) !=cgiFormSuccess)
{
fprintf(stderr,"could not retrieve filename/n");
goto FAIL;
}
cgiFormFileSize("file", &size);
//取得文件类型，不过本例中并未使用
cgiFormFileContentType("file", contentType, sizeof(contentType));
//目前文件存在于系统临时文件夹中，通常为/tmp，通过该命令打开临时文件。临时文件的名字与用户文件的名字不同，所以不能通过路径/tmp/userfilename的方式获得文件
if (cgiFormFileOpen("file", &file) != cgiFormSuccess)
{
fprintf(stderr,"could not open the file/n");
goto FAIL;
}
t=-1;
//从路径名解析出用户文件名
while(1)
{
tmpStr=strstr(name+t+1,"//");
if(NULL==tmpStr)
tmpStr=strstr(name+t+1,"/");//if "//" is not path separator, try "/"
if(NULL!=tmpStr)
t=(int)(tmpStr-name);
else
break;
}
strcpy(fileNameOnServer,name+t+1);
mode=S_IRWXU|S_IRGRP|S_IROTH;
//在当前目录下建立新的文件，第一个参数实际上是路径名，此处的含义是在cgi程序所在的目录（当前目录））建立新文件
targetFile=open(fileNameOnServer,O_RDWR|O_CREAT|O_TRUNC|O_APPEND,mode);
if(targetFile<0)
{
fprintf(stderr,"could not create the new file,%s/n",fileNameOnServer);
goto FAIL;
}
//从系统临时文件中读出文件内容，并放到刚创建的目标文件中
while (cgiFormFileRead(file, buffer, BufferLen, &got) ==cgiFormSuccess)
{
if(got>0)
write(targetFile,buffer,got);
}
cgiFormFileClose(file);
close(targetFile);
goto END;
FAIL:
fprintf(stderr,"Failed to upload");
return 1;
END:
printf("File %s has been uploaded",fileNameOnServer);
return 0;
}