boa_cgic-WebServer开发

吴浩皛

2023-12-01

概述

选择boa作为web服务器优势：
网上资料比较多
占用flash资源较少

BOA

交叉编译

环境：boa-0.94.13
1、./configure
2、vi Makefile

LDFLAGS = -staic
CROSS_COMPILE = YOU CROSS COMPILE TOOL PREFIX
CC = $(CROSS_COMPILE)gcc 
CPP = $(CROSS_COMPILE)gcc -E

3、make
编译出来的src/boa，即webserver主进程。

编译报错

1、“unable to dup2 the error log”
log.c::open_logs

	#if 0
    /* redirect stderr to error_log */
    if (dup2(error_log, STDERR_FILENO) == -1) {
        DIE("unable to dup2 the error log");
    }
    #endif

2、TIMEZONE_OFFSET error
compat.h

#ifdef HAVE_TM_GMTOFF
#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
#else
#define TIMEZONE_OFFSET(foo) timezone
#endif

添加环境变量

boa使用的是自己配置的环境变量，它没有用设备的env。
如果设备内一些lib、bin放在自定的目录下，则必须在boa中添加对应环境变量路径，否则cgi无法使用上述lib、bin。
修改过程如下：
在cgi.c中：

int complete_env(request * req)
{
    //...
    //指定库路径
    my_add_cgi_env(req, "LD_LIBRARY_PATH", "/mnt/data/lib");
    //指定bin路径
	my_add_cgi_env(req, "PATH", "/mnt/data/bin:/bin:/sbin:/usr/bin:/usr/sbin");
}

配置文件

修改配置文件路径

defines.h

#ifndef SERVER_ROOT
#define SERVER_ROOT "/etc/boa"  //在该地址下找boa.conf
#endif

配置信息说明

# webserver端口
Port 80
# 网页文件路径
DocumentRoot /var/www
# mime.types文件路径
MimeTypes /etc/mime.types
# cgi程序路径，只有两个参数，修改路径示例：ScriptAlias /cgi-bin/ /you_path/cgi-bin/
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
# 决定在浏览器输入ip后，进入的是那个html
DirectoryIndex net_config.html

注意

ScriptAlias必须以cgi-bin名字作为目录名，否则将找不到cgi程序。
未验证：这个路径和html的action路径一致，如果html把路径改为:action=“bin/login.cgi”，那么配置文件要把ScriptAlias改为bin。

mime.types

webserver需要该文件，来约定服务器支持的文件类型。
如果设备内没有mime.types，需要在网上下载一个，拷贝至配置文件MimeTypes指定的路径下即可。

CGIC

用C封装了很多处理html数据的接口，便于cgi开发。

编译

cgi开发

作用

用于页面和webserver之间的数据交互。
当html的表单触发对应action，例如action=“cgi-bin/login.cgi”，则将转到C编写的cgi程序继续执行。

编写

cgi程序需要实现cgiMain入口函数，并且在编译时，将cgic.c(CGIC库)编译进去

编译

示例:

gcc -o test.cgi test.c cgic.c

POST/GET

post

html通过post提交表单，调用对应的cgi程序，表单信息就可以被cgi访问到.
例如：

<form name="login_form" onSubmit="return js_login_check( )" enctype="multipart/form-data" action="cgi-bin/login.cgi" method="post" >
	<div>
	<img src="img/logo.png" class="logo_img"/><br />
		<b>用户名：</b>
		<input class="name_input" type="text" value="admin" readonly="readonly" name="username" id="username" /><br />
	</div>
	<div>
		<b>密&nbsp;&nbsp;&nbsp;码：</b>
		<input class="pwd_input" type="password" placeholder="密码为数字或者英文字母" name="passwd" id="passwd" /><input style="border:none;" class="right_input" type="button" value="忘记密码?" onclick="warning_box()"/>
	</div>
	<button>取消</button/><button type="submit" class="sub"   >登录</button>
</form>

其中，action指定cgi程序，method指定方法。
cgi通过getenv(“QUERY_STRING”)，可以获取该方法名。

get

获取设备信息。例如：

	function get_dev_time()
	{		
		var xmlhttp;
		if(window.XMLHttpRequest)
		{
			xmlhttp=new XMLHttpRequest();
		}
		else
		{
			xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
		}
		xmlhttp.onreadystatechange=function()
		{
	  	    if(xmlhttp.readyState==4 && xmlhttp.status==200)
	        {
		        var jsonstr = xmlhttp.responseText;
		        var json = JSON.parse(jsonstr);
		        var formid = "main_part";
		        time_json_parse(json,formid);
	        }
		}
		xmlhttp.open("GET","cgi-bin/get_config.cgi?cur_time=" + new Date().getTime()+"-get_time",false);
		xmlhttp.send();
	}

其中xmlhttp.send发送xml格式数据，数据内容为xmlhttp.open中的内容。

cookie

1.每个cgi，开始都getenv("HTTP_COOKIE")。  
如果结果为空，跳转到登录界面，如果不空，正常显示。  
2.登录界面发送用户名密码给cgi验证。  
验证失败，还在登录界面，验证成功，printf("Set-Cookie:hash_key=%s/n", hash_key);  
3.当关闭浏览器时，HTTP_COOKIE会被清掉。

DEBUG

cgi_header: unable to find LFLF

现象

单独执行cgi程序没有问题，通过网页调用cgi程序boa就报该错误。

分析

使用demo cgi程序(不链接任何库，仅输出一条信息)，时运行时正常的。
当cgi程序连接了外部库，就出现上述问题。
考虑到链接的外部库不在标准路径下，在/mnt/data/lib下，是否是因为找不到库文件，导致cgi执行出错呢？

解决

boa使用它自己的环境变量，它没有用env里面的环境变量。
添加环境变量，参考BOA环境变量一节。

cgi中执行外部命令失败

问题原因同“cgi_header: unable to find LFLF”，也是没有配置环境变量导致的问题。
在cgi.c将PATH添加到环境变量中即可。

Ajax页面缓存问题

页面每次调用一次get后，获取的数据都是一样的，即使设备端对应值变了。

解决

页面发送get消息时，已下述方式发送：

	xmlhttp.open("GET","cgi-bin/get_config.cgi?cur_time=" + new Date().getTime(),false);