Tinyhttpd 源码学习

Tinyhttpd 是一个超轻量型 Http Server,使用C语言开发,附带一个简单的Client,通过学习 Tinyhttpd 可以帮助理解一个 Http Server 的本质。源码可以在这个网站获取:https://sourceforge.net/projects/tiny-httpd/

首先将源码下载到本地,我们可以看到项目代码主要有主程序 httpd.c ,一个客户端 simpleclient.c ,htdocs 下则是一个界面和一些 cgi 脚本,其它则是一些编译相关的文件,项目结构如下图:


其中,httpd 与 client 是 在项目下运行 make all 命令生成的可执行程序,运行 httpd ,在浏览器打开可以看到如下的界面:
界面

这就是一个可以提供 http 服务的 http server 啦,下面我们来看下主程序,即 httpd.c 文件。


主文件开头有两段注释,一个是程序注解,包括了程序的简单描述,作者,时间,(好家伙,1999年,远古大神),还有地址,这也是国际惯例了,大家在编码的时候也要良好的习惯哈。
另一段则说明了这个程序是在 Sparc Solaris 2.6 下编写运行的,如果要在 linux 下编译运行的话需要改变一些编码,按照说明一一修改即可。

一般情况下, 在代码层面 main 函数就是程序运行的起点,因此我们阅读源码也从 main 函数入手,我们可以在 main 函数开头看到,作者创建了一些局部变量用来保存后续创建网络连接的参数与一个客户端变量,在后续的代码中,我们可以更直观的看到这些参数的作用。



随后,调用 startup 函数,传入之前创建的 port 参数,并用 server_sock 记录返回值,这里就是 sock fd。



接下来我们进入 startup 函数看看其做了什么,首先调用 系统函数 socket 创建了一个 socket ,随后设置网络地址与端口并保存在一个 sockaddr_in 的结构中,变量名为 name,紧接着调用系统函数 setsockopt ,这个函数的作用是保证在一定时间内返回,从而避免在 tcp 连接中调用某些函数时一直阻塞,然后调用系统函数 bind 将之前创建的 socket 与 地址端口 name 进行绑定,接下来,添加了一个对 端口为零的判断,如果为零的话则对其进行动态分配,并将分配的值赋予 port 参数。最后,开启对该 socket 的监听,返回该的 socket fd 至函数的调用者 main 函数中。
startup

接着回到 main 函数,可以看到开启了一个一直运行的循环,循环体内,调用 系统函数 accept ,这是一个阻塞函数,从已经建立连接的队列中取出一个连接返回给 client_sock,并赋值 client_name 。然后判断如果这个连接的值为 -1 ,说明发生错误,就调用辅助函数 error_die 打印错误并退出程序。如果连接有效,就调用 accept_request 函数去进行处理,处理完就会重新进入循环,依旧从 accept 函数执行,如果没有出现连接错误就会一直运行下去。


我们进入 accept_request 函数看下是如何处理客户端请求的:

  1. 首先声明 client buf 等需要用到的局部变量。

  2. 然后调用 get_line 从客户端与服务端的连接socket 中读取数据。

  3. 随后对读取到的数据进行处理:
    a. 首先从数据头部读取请求方法;
    b. 再根据请求方法去选择下面的行为,如果方法为 “get" "post" 并存,则调用 unimplemented 函数返回错误信息,并返回主函数;
    c. 如果是 post 方法,把 cgi 设置为 1;
    d. 接着 读取 url ;
    e. 对 url 进行解析,如果方法为 get 并且 url 中 包含 ’?‘ 字符,则把 cgi 设置为1;
    f. 把 url 存入 path 变量中,如果url 最后为 ‘' ,则在 path 末尾 添加 ’index.html' ;
    g. 使用 stat 从 path 中获取文件信息,并保存在 stat 中。
    h. 如果上一步出错,则把剩余数据读完,然后调用 not_found 返回错误;
    i. 接着判断是否是一个文件夹,如果是,在 path 后面添加上 ‘index.html’ ;
    j. 接着判断如果有执行权限,则设置 cgi 为 1;


    这里使用位模式判断文件类型与执行权限
  4. 最后如果 cgi 为 0,则调用serve_file 函数,如果 cgi 为 1, 则调用 execute_cgi 函数,
    最后关闭 socket 并返回。

serve_file 函数 则是把客户端请求的文件以流的形式发给客户端,调用了 cat 函数。

execute_cgi 函数 顾名思义,就是执行 cgi 脚本了,具体的话:

  1. 判断请求类型,如果为 get 则无需处理,如果为 post 则读取 content_lentgh 与 content;
  2. 建立 cgi 输入输出管道。
  3. 建立成功后发送请求成功头;
  4. 使用子进程执行 cgi 请求:
    a. 重定向输入输出管道,关闭无用管道;
    b. 设置 cgi 环境;
    c. 执行 path, 退出 子进程。
  5. 主进程则负责将收到的 post 写入输入管道供子进程读取,并将输出管道中子进程处理后的消息取出发送给客户端。

最后,建议阅读顺序为 main -> startup -> accept_request -> serve_file -> execute_cgi.

其它就是一些辅助工具类函数了,
bad_request 用于返回客户端错误请求信息,
cat 把文件所有信息发送给客户端,
cannot_execute 返回客户端服务器无法执行 cgi 的信息,
error_die 打印错误并跳出循环退出程序,
get_line 按行读取 socket 数据并返回数据字节数,
headers 返回 http 头信息给客户端,
not_found 返回客户端 404 错误信息,
unimplemented 返回客户端请求方法不支持信息。

这虽然是一份只有 500 行的代码,但是可以帮助了解一个简单的服务器的实现与基本功能,此外大佬的代码风格还是很值得学习的。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,588评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,456评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,146评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,387评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,481评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,510评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,522评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,296评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,745评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,039评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,202评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,901评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,538评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,165评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,415评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,081评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,085评论 2 352

推荐阅读更多精彩内容