建站服务器 1. Boa简介

Boa是一种非常小巧的Web服务器，其可执行代码只有大约60KB左右。作为一种单任务Web服务器，Boa只能依次完成用户的请求，而不会fork出新的进程来处理并发连接请求。但Boa支持CGI，能够为CGI程序fork出一个进程来执行。Boa的设计目标是速度和安全，适合于嵌入式系统的单任务的http服务器，源代码开放、性能高。

下面给大家介绍一下Boa服务器在SylixOS上移植的具体操作步骤，希望能够有帮助。

2. SylixOS Boa移植：

Boa采用服务器模型，因此需要编译出服务器的可执行程序。

2.1 下载Boa源码

在官网下载第三方中间件的资源，Boa的官方网站为：http://www.boa.org/。本文中使用的版本是boa-0.94.13，下载后解压文件，文件目录如图 2-1所示。

                  

                                                    

图 2-1 Boa解压后的文件

2.2 服务器工程创建

在Real-Evo IDE中创建boa_sylixos应用工程，删除工程中src目录下的boa_sylixos.c文件，导入源码中的src目录下的一系列相关.c和.h文件。导入完成后的工程文件如图 2-2所示。

                                                   

                                                          

图 2-2 工程文件

2.3 修改源码文件

具体源码文件修改，详见《移植boa服务器过程文档》。

2.4 修改boa.conf配置文件

在boa-0.94.13目录下已有一个示例boa.conf，可以在其基础上进行修改。如下：

(1)Group的修改

修改：Group nogroup

为 ：Group 0

(2)user的修改

修改：User nobody

为 ：User 0

(3)ScriptAlias的修改

修改：ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/

为 ：ScriptAlias /cgi-bin/ /var/www/cgi-bin/

(5)DoucmentRoot的修改

DoucmentRoot /var/www

(6)ServerName的设置

修改：#ServerName www.your.org.here

为 ：ServerName www.your.org.here

否则会出现错误“gethostbyname::No such file or directory”

(7)AccessLog修改

修改：AccessLog /var/log/boa/access_log

为：#AccessLog /var/log/boa/access_log

否则会出现错误提示：“unable to dup2 the error log: Bad file descriptor”

2.5 编译生成boa_sylixos可执行文件

编译生成可执行文件boa_sylixos，并将之上传至目标机/etc/boa目录下；

2.6 拷贝mime.types文件

将linux /etc目录下的mime.types文件拷贝到目标机/etc目录下；（mime.types文件用来指明不同文件扩展名对应的MIME类型，一般可以直接从Linux主机上拷贝一个，大部分也都是在主机的/etc目录下。）

2.7 新建工程boa_cgi_child_func

目的：实现Boa源码中的fork函数功能

1) 创建app工程，修改boa_cgi_child_func.c文件，加入如下代码：

#include <stdio.h>

#include <stdlib.h>

 

#define NI_MAXHOST                  20

#define CGI_ENV_MAX                 50

#define SOCKETBUF_SIZE              8192

#define MAX_HEADER_LENGTH           1024

#define CLIENT_STREAM_SIZE          SOCKETBUF_SIZE

#define BUFFER_SIZE                 CLIENT_STREAM_SIZE

 

struct mmap_entry {

    dev_t dev;

    ino_t ino;

    char *mmap;

    int use_count;

    size_t len;

};

 

struct request {                /* pending requests */

    int fd;                     /* client\'s socket fd */

    int status;                 /* see #defines.h */

    time_t time_last;           /* time of last succ. op. */

    char *pathname;             /* pathname of requested file */

    int simple;                 /* simple request? */

    int keepalive;              /* keepalive status */

    int kacount;                /* keepalive count */

 

    int data_fd;                /* fd of data */

    unsigned long filesize;     /* filesize */

    unsigned long filepos;      /* position in file */

    char *data_mem;             /* mmapped/malloced char array */

    int method;                 /* M_GET, M_POST, etc. */

 

    char *logline;              /* line to log file */

 

    char *header_line;          /* beginning of un or incompletely processed header line */

    char *header_end;           /* last known end of header, or end of processed data */

    int parse_pos;              /* how much have we parsed */

    int client_stream_pos;      /* how much have we read... */

 

    int buffer_start;           /* where the buffer starts */

    int buffer_end;             /* where the buffer ends */

 

    char *http_version;         /* HTTP/?.? of req */

    int response_status;        /* R_NOT_FOUND etc. */

 

    char *if_modified_since;    /* If-Modified-Since */

    time_t last_modified;       /* Last-modified: */

 

    char local_ip_addr[NI_MAXHOST]; /* for virtualhost */

 

    /* CGI vars */

 

    int remote_port;            /* could be used for ident */

 

    char remote_ip_addr[NI_MAXHOST]; /* after inet_ntoa */

 

    int is_cgi;                 /* true if CGI/NPH */

    int cgi_status;

    int cgi_env_index;          /* index into array */

 

    /* Agent and referer for logfiles */

    char *header_user_agent;

    char *header_referer;

 

    int post_data_fd;           /* fd for post data tmpfile */

 

    char *path_info;            /* env variable */

    char *path_translated;      /* env variable */

    char *script_name;          /* env variable */

    char *query_string;         /* env variable */

    char *content_type;         /* env variable */

    char *content_length;       /* env variable */

 

    struct mmap_entry *mmap_entry_var;

 

    struct request *next;       /* next */

    struct request *prev;       /* previous */

 

    /* everything below this line is kept regardless */

    char buffer[BUFFER_SIZE + 1]; /* generic I/O buffer */

    char request_uri[MAX_HEADER_LENGTH + 1]; /* uri */

    char client_stream[CLIENT_STREAM_SIZE]; /* data from client - fit or be hosed */

    char *cgi_env[CGI_ENV_MAX + 4];             /* CGI environment */

 

#ifdef ACCEPT_ON

    char accept[MAX_ACCEPT_LENGTH]; /* Accept: fields */

#endif

};

 

typedef struct request request;

 

int main (int argc, char **argv)

{

    void   (*child_func)(request *req,int *pipes,int use_pipes);

    request *req;

    int     *pipes;

    int     use_pipes;

 

    child_func  = (void *)   atoi(argv[0]);

    req         = (request *)atoi(argv[1]);

    pipes       = (int *)    atoi(argv[2]);

    use_pipes   = *((int *)  atoi(argv[3]));

    child_func(req,pipes,use_pipes);

 

    return  (0);

}

2) 编译生成boa_cgi_child_func可执行文件，利用FTP工具上传到目标机/etc/boa目录下。

2.8 测试Boa服务器功能2.8.1 不包含cgic库的CGI程序

1) index.html 网页

<html>

<head><title>CGI登陆</title></head>

<body>

<form name=login action=./cgi-bin/login.cgi>姓名：<input type=text name=name />

<br/>密码：<input type=password name=pwd />

<br/>确定：<input type=submit value=登陆 />

</form>

</body>

</html>

2) test.c CGI测试程序代码

#include<stdio.h>

#include<stdlib.h>

int main()

{

char *date;

char name[50],pwd[20];

printf(content-type:text/html;charset=gb2312\\n\\n);

printf(<TITLE>登陆结果</TITLE>);

printf(<H3>登陆结果</h4>);

date=getenv(QUERY_STRING);

if(date==NULL)

printf(<p>错误：数据没有被输入或数据传输发生错误</p>);

else

{

sscanf(date,name=%[^&]&pwd=%s,name,pwd);

printf(<p>name=%s</p>,name);

printf(<p>pwd=%s</p>,pwd);

printf(%s,date);

}

return 0;

}

3) 操作流程

a) 将index.html拷贝到先前我们创建的/var/www目录下；

b) 在IDE中新建boa_test应用工程，生成测试CGI程序：boa_test；

c) 将boa_test拷贝到/var/www/cgi-bin目录下

d) 执行./boa_sylixos

e) 在浏览器地址栏输入http://192.168.7.32/index.html，产生如图 2-3所示。

图 2-3 index.html登陆界面

f) 在姓名和密码栏分别输入相应值，点击登陆按钮，进入如图 24所示界面。

                                                  

图 2-4 CGI响应程序执行

2.8.2 包含cgic库的CGI程序

1) 操作流程

g) 从CGI官网（http://www.boutell.com/cgic/）上下载cgic库文件；

h) 在RealEvo IDE中创建boa_cgictest应用工程；

i) 把cgic.h、cgic.c、cgictest.c 拷贝到工程boa_cgictest源码文件所在的目录src下，然后编译生成boa_cgictest文件，并将之上传到目标机/var/www/cgi-bin目录下；

j) 执行./boa_sylixos

k) 在浏览器地址栏输入http://192.168.7.32/cgi-bin/boa_cgictest，效果如图 25所示。

图 25 CGI响应程序执行

可以看到一个网页被展示出来。这样，包含cgic库的的CGI程序就运行起来了。

3. 参考资料

1) http://blog.chinaunix.net/uid-20620288-id-3139686.html

2) http://blog.csdn.net/manchestermi/article/details/50826129