嵌入式设备web开发笔记：boa和cgic

序

环境

编译环境

• ubuntu 16.04
• arm-linux-gcc 4.6.3

运行环境

• arm9 linux 2.6.39

库版本

• boa 0.94
• cgic 2.07

boa移植

boa是一个非常轻量的http服务器，支持cgi，编译出来203K（strip后59K），内存占用600K左右，用在嵌入式设备上再合适不过。

下载

最新版本0.94，发布于2005年(好久远)，可以直接在官网下载

安装

boa的安装直接参考官方文档：http://www.boa.org/documentation/boa-2.html
这里提几点：

1. boa的编译需要byacc和flex，在ubuntu下直接使用apt安装：

sudo apt install byacc
sudo apt install flex

在src/目录下输入命令./configure可以生成Makefile，然后修改makefile使用交叉编译器：

使用交叉编译器

2. 代码有四个位置要稍做修改：

   
   
   boa.c这里不注释掉运行时会报错icky Linux kernel bug!

compat.h这里不修改会编译不过去

defines.h这里修改运行路径，不改也可以在运行时使用-c选项来指定

如果用动态库的话，cgi.c这里要加一下动态库的路径环境变量，不然动态库是用不了的

然后就可以愉快的编译了，编译完可以strip一下，减小体积。

3. 将编译好的boa、根目录的boa.conf、box_indexer、linux下/etc/mime.types复制出来。boa.conf比较简单，基本能看懂，下面是我的配置供参考：

   
   
   框出来的是我修改过的，其他是默认
   
   

   需要注意的是ErrorLog和AccessLog的文件夹如果不存在的话服务器是启动不了的，所以我直接放在tmp下面了，正式运行环境可以存到flash中或直接关掉。

4. 把上述4个文件放入arm板中，另外可以放一个简单的index.html做测试。boa一定要给执行权限，使用source是没法运行起来的，在root用户下直接运行boa，没有报错的话应该就运行起来了，访问arm板的80端口试试吧。

5. 再说一个坑，cgi程序必须放在cgi-bin或htbin(没试过)目录下，并且要给运行权限，否则你就会看到：

502 Bad Gateway
The CGI was not CGI/1.1 compliant.

cgic

cgic是c语言的cgi库，最新版本2.07，发布于2016年，官网已经挂了，只有github。库本身比较简单，直接下载下来改下Makefile的编译器就能编译。
说起来用c语言来做web有点匪夷所思，不过在嵌入式的世界好像也没啥奇怪的，毕竟资源就那么多，也不用做并发，像路由器那样给单个用户提供一些系统信息、支持设置常用参数就够了。

怎么用这个库

cgic编译出来是一个静态库，61K（strip后34K），自己的程序调他的头文件、链接他的静态库就ok了。如果cgi比较多，用动态库可以减少空间占用。

基本概念

cgic执行以下任务：
1.解析数据，校正有缺陷和不一致的浏览器
2.透明的接受由GET和POST传递的表单数据
3.接受上传完毕的文件和普通的表单数据
4.提供设置和恢复cookies的函数
5.以一致的方式处理表单字段的换行符
6.提供字符串，整数，浮点数，单选，多选 函数来恢复表单数据
7.对于数字字段提供边界检查
8.加载CGI环境变量到C字符串，这些字符串总是不为空
9.在调试环境下，提供捕获CGI状态的方法，包括文件上传和cookies

参考

https://markrepo.github.io/protocol/2018/06/25/cgic/

坑

1. 程序如果跑到一半挂了，只能输出挂之前的html，之后的就没有了，这也没什么坑的，但是，由于linux的缓存输出机制，导致挂之前的html也有可能输出不全。比如stdout的缓存是4k，cgi程序挂掉之前输出了5K的html，那么前4K是可以被系统正常flush然后输出的，但是最后1k是没法输出的，这就导致可能出现一些奇怪的网页输出一半就没了的问题。
2. 不调用cgiHeaderContentType("text/html");会导致错误如下：

502 Bad Gateway
The CGI was not CGI/1.1 compliant.

还没写完，先留个坑。