嵌入式linux 项目开发(一)——CGIC编程

嵌入式linux 项目开发(一)——CGIC编程

1、CGIC简介

1CGI简介

        CGICommon Gateway Interface)是外部应用扩展应用程序与WWW服务器交互的一个标准接口。按照CGI标准编写的外部扩展应用程序能够处理客户端浏览器输入的数据,从而完成客户端与服务器的交互操做。而CGI规范就定义了Web服务器如何向扩展应用程序发送消息,在收到扩展应用程序的信息后又如何进行处理等内容。通 过CGI能够提供许多静态的HTML网页没法实现的功能,好比搜索引擎、基于Web的数据库访问等等。html

CGI的主要功能:linux

    A分析数据,并自动校订一些有缺陷的浏览器发来的数据web

    B、透明接收用GET或 POST方法发来的From数据数据库

    C、能接受上传文件编程

    D  、可以设置和接收cookies数组

    E、用一致的方式处理From元素里的回车浏览器

    F、提供字符串,整数,浮点数,单选或多选功能来接收数据安全

    G、提供数字字段的边界检查服务器

    H、可以将CGI环境变量转化成C中的非空字符串cookie

    I、提供CGI程序的调试手段,可以回放CGI程序执行时的CGI状态

2BOACGI工做机制

    BOACGI的工做机制:

        HTTP协议是WWW的基础,基于客户/服务器模型,服务器能够为分布在网络中的客户提供服务。HTTP创建在TCP/IP协议之上的无链接协议,每次链接只处理一个请求。在BOA服务器上,运行产着一个守护进程对端口进行监听,等待来自客户的请求。当一个请求到来时,将建立一个子进程为用户的链接服务。根据请求的不一样,服务器返回HTML文件或者经过CGI调用外部应用程序,返回处理结果。服务器经过CGI与外部程序和脚本之间进行交互,根据客户端在进行请求时所采起的方法,服务器会收集客户所提供的信息,并将该部分信息发送给指定的CGI扩展程序。CGI扩展程序进行信息处理并将结果返回服务器,而后服务器 对信息进行分析,并将结果发送回客户端。

    外部CGI程序与BOA服务器进行通讯、传递有关参数和处理结果是经过环境变量、命令行参数和标准输入来进行的。服务器提供了客户端(浏览器)与CGI扩展程序之间的信息交换的通道。CGI的标准输入是服务器的标准输出,而CGI的标准输出是服务器的标准输入。客户的请求经过服务器的标准输出传送给CGI的标准输入,CGI对信息进行处理后,将结果发送到它的标准输入,而后由服务器将处理结果发送给客户端。

         CGIC是一个功能比较强大的支持CGI开发的标准C库,并支持LinuxUnix Windows等多操做系统。

        CGIC的主站点http://www.boutell.com/cgic/

三、URL简介

    客户端浏览器向服务器发送数据采用编码的形式进行,编码就是URL编码。编码的主要工做是表单域的名字和值的转义,具体的作法为:每一对域和值里的空格都会被替换为一个加号(+)字符,不是字母或数字的字符将被替换为它们的十六进制数字形式,格式为%HHHH是字符的ASCII十六进制值。<BR>标签将被替换为“%0D%0A”

    信息是按它们在表单里出现的顺序排列的。数据域的名字和数据域的值经过等号=)字符连在一块儿。各对名/值再经过“&”字符链接在一块儿。通过这些编码处理以后,表单信号就整个成为一个连续的字符流,里面包含着将被送往服务器的所有信息。

    由于表单输入信息都是通过编码后传递给脚本程序的,因此CGI扩展程序在使用这些参数以前必须对它们进行解码。

2、CGIC编译配置

1、下载CGIC源码

    tar -zxvf cgic206.tar.gz

2、修改Makefile文件

CC=arm-linux-gcc

AR=arm-linux-ar

RANLIB=arm-linux-ranlib

CFLAGS=-g -Wall -static

 cgictest.cgi: cgictest.o libcgic.a

      $(CC) $(CFLAGS) cgictest.o -o cgictest.cgi ${LIBS}

 capture: capture.o libcgic.a

      $(CC) $(CFLAGS) capture.o -o capture ${LIBS}

3、编译

    make

    编译获得的文件

    libcgic.a:CGIC

    capture:调试辅助程序

    cgictest.cgi:测试程序

四、安装CGIC

    make install

    CGIC安装路径为

    libcgic.a 安装在/usr/local/lib

    cgic.h 安装在/usr/local/include

    CGIC库安装后就可使用CGIC编程了

5CGIC文件的移植

    将capture和cgictest.cgi拷贝到开发板的/var/www/cgi-bin目录

六、运行cgi程序

    在客户端浏览器运行http://192.168.6.210/cgi-bin/cgictest.cgi

    若是正常显示网页内容,则BOACGIC能够正常工做

3、CGIC移植过程当中错误的解决

1html网页能够运行,CGI程序运行报错

    Boa服务器报错:cgi_header: unable to find LFLF

    客户端浏览器报错:502 Bad Gateway

                                                The CGI was not CGI/1.1 compliant.

    解决方法:静态编译cgi程序

    arm-linux-gcc -o hello.cgi hello.c -static

 

4、CGIC编程

一、CGI通讯方式

    当有数据从客户端浏览器传到Web服务器后,web服务器会根据传送的类型(基本有二类:GET/POST),将接收到的数据传入 QUERY_STRING或变量中, CGI程序能够经过标准输入,在程序中接收web服务器接收的数据。当要向浏览器发送信息时,只要向Web服务器发送特定的文件头信息,便可经过标准输出将信息发往Web服务器, Web服务器处理完由CGI程序发来的信息后就会将信息发送给浏览器。

二、接收数据

    用GET方式接收到的数据保存在Web服务器的QUERY_STRING 变量里,而经过POST方式接收到的数据是保存在Web服务器变量里。两种数据接收方式的区别是:以GET方式接收的数据是有长度限制,而用POST方式接收的数据是没有长度限制的;以GET方式发送数据,能够经过URL的形式来发送,但POST方式发送的数据必需要经过Form才到发送。 

三、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输入

4CIGC库主要函数

    用通常 ANSI CC++编译器就能够编译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环境以便用来调试。

五、CGI结果编码

CGIC结果编码参考:
cgiFormSuccess 
提交信息成功 
cgiFormTruncated 
删除部分字节. 
cgiFormBadType 
错误的输入信息(没有按要求) 
cgiFormEmpty 
提交信息为空. 
cgiFormNotFound 
提交信息没有找到. 
cgiFormConstrained 
数字属于某个特定的范围,被迫低于或高于适当范围。 
cgiFormNoSuchChoice 
单一选择提交的值是不被接受。一般说明表但和程序之间存在矛盾。 
cgiEnvironmentIO 
从CGI环境或获取的文件读或写的企图失败,报出I/O的错误。 
cgiEnvironmentMemory 
从CGI环境或获取的文件读或写的企图失败,报出out-of-memory的错误。 
cgiEnvironmentSuccess 
从CGI环境或获取的文件读或写的企图成功。

六、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>\n", name); 

    获取并显示由用户输入的 name

9、处理单一复选框

1
2
3
4
5
6
7
8
9
10
11
void  Hungry() 
     if  (cgiFormCheckboxSingle( "hungry" ) == cgiFormSuccess) 
    
         fprintf (cgiOut,  "I'm Hungry!<BR>\n" );  
    
     else 
    
         fprintf (cgiOut,  "I'm Not Hungry!<BR>\n" );  
    
}

    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>\n", temperature); 

    cgiFormDoubleBounded 返回的值被检查确信用户输入的资料在规定范围内, 而不是其余无效的数据

11、处理单一选择输入

char *colors[] = { 
"Red", 
"Green", 
"Blue" 
}; 

void Color()


    int colorChoice; 
    cgiFormSelectSingle("colors", colors, 3, &colorChoice, 0); 
    fprintf(cgiOut, "I am: %s<BR>\n", colors[colorChoice]); 

12、处理多项选择的输入

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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>\n" ); 
     result = cgiFormCheckboxMultiple( "vote" , votes, 4, voteChoices, &invalid); 
     if  (result == cgiFormNotFound) 
    
         fprintf (cgiOut,  "I hate them all!<p>\n" ); 
    
     else 
    
         fprintf (cgiOut,  "My preferred candidates are:\n" ); 
         fprintf (cgiOut,  "<ul>\n" ); 
         for  (i=0; (i < 4); i++) 
        
             if  (voteChoices[i]) 
            
                 fprintf (cgiOut,  "<li>%s\n" , votes[i]); 
            
        
         fprintf (cgiOut,  "</ul>\n" ); 
     }
}

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

5、文件上传编程实例

1HTML网页制做

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<!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程序编程

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
#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;   
}