A mirror for tinyhttpd(Tinyhttpd非ひ官かん方かた镜像,Fork自じsourceForge,仅供学がく习)

测试CGI时需要じゅよう本ほん机つくえ安あん装そうPERL，同どう时安装そうperl-cgi

Compile for Linux

 To compile for Linux:
  1) Comment out the #include <pthread.h> line.
  2) Comment out the line that defines the variable newthread.
  3) Comment out the two lines that run pthread_create().
  4) Uncomment the line that runs accept_request().
  5) Remove -lsocket from the Makefile.

     每まい个函数すう的てき作用さよう：

     accept_request:  处理从套接せっ字じ上じょう监听到的てき一いち个 HTTP 请求，在ざい这里可か以很大だい一部分地体现服务器处理请求流程。

     bad_request: 返かえし回かい给客户端这是个错误请求もとめ，HTTP 状じょう态吗 400 BAD REQUEST.

     cat: 读取服ふく务器上じょう某ぼう个文件けん写うつし到いた socket 套接字じ。

     cannot_execute: 主要しゅよう处理发生在ざい执行 cgi 程ほど序じょ时出现的错误。

     error_die: 把わ错误信しん息いき写うつし到いた perror 并退出たいしゅつ。

     execute_cgi: 运行 cgi 程ほど序じょ的てき处理，也是个主要よう函数かんすう。

     get_line: 读取套接字じ的てき一いち行ぎょう，把わ回かい车换行ぎょう等とう情じょう况都统一为换行符结束。

     headers: 把わ HTTP 响应的てき头部写うつし到いた套接字じ。

     not_found: 主要しゅよう处理找不到いた请求的てき文ぶん件けん时的情じょう况。

     sever_file: 调用 cat 把わ服ふく务器文ぶん件けん返かえし回かい给浏览器。

     startup: 初はつ始はじめ化か httpd 服ふく务，包括ほうかつ建立こんりゅう套接字じ，绑定端はし口こう，进行监听等とう。

     unimplemented: 返かえし回かい给浏览器表明ひょうめい收おさむ到いた的てき HTTP 请求所用しょよう的てき method 不ふ被ひ支持しじ。

     建たて议源码阅读顺序じょ： main -> startup -> accept_request -> execute_cgi, 通つう晓主要よう工作こうさく流りゅう程ほど后きさき再さい仔こ细把每ごと个函数すう的てき源げん码看一いち看み。

     （1） 服ふく务器启动，在ざい指定してい端はし口こう或ある随ずい机つくえ选取端はし口こう绑定 httpd 服ふく务。

     （2）收おさむ到いた一いち个 HTTP 请求时（其实就是 listen 的てき端はし口こう accpet 的てき时候），派生はせい一个线程运行 accept_request 函数かんすう。

     （3）取出とりで HTTP 请求中ちゅう的てき method (GET 或ある POST) 和かず url,。对于 GET 方法ほうほう，如果有ゆう携带参さん数すう，则 query_string 指ゆび针指向しこう url 中ちゅう ？ 后きさき面めん的てき GET 参さん数すう。

     （4） 格式かくしき化か url 到いた path 数すう组，表示ひょうじ浏览器き请求的てき服ふく务器文ぶん件けん路ろ径みち，在ざい tinyhttpd 中ちゅう服ふく务器文ぶん件けん是ぜ在ざい htdocs 文ぶん件けん夹下。当とう url 以 / 结尾，或ある url 是ぜ个目录，则默认在 path 中ちゅう加か上じょう index.html，表示ひょうじ访问主ぬし页。

     （5）如果文ぶん件けん路ろ径みち合法ごうほう，对于无参数すう的てき GET 请求，直接ちょくせつ输出服ふく务器文ぶん件けん到いた浏览器き，即そく用よう HTTP 格式かくしき写うつし到いた套接字じ上じょう，跳とべ到いた（10）。其他情じょう况（带参数すう GET，POST 方式ほうしき，url 为可执行文こうぶん件けん），则调用よう excute_cgi 函数かんすう执行 cgi 脚本きゃくほん。

    （6）读取整せい个 HTTP 请求并丢弃，如果是ぜ POST 则找出で Content-Length. 把わ HTTP 200  状じょう态码写うつし到いた套接字じ。

    （7） 建立こんりゅう两个管かん道どう，cgi_input 和わ cgi_output, 并 fork 一いち个进程ほど。

    （8） 在ざい子こ进程中ちゅう，把わ STDOUT 重定しげさだ向こう到いた cgi_outputt 的てき写うつし入にゅう端はし，把わ STDIN 重定しげさだ向こう到いた cgi_input 的てき读取端はし，关闭 cgi_input 的てき写うつし入にゅう端はし 和わ cgi_output 的てき读取端はし，设置 request_method 的てき环境变量，GET 的てき话设置おけ query_string 的てき环境变量，POST 的てき话设置おけ content_length 的てき环境变量，这些环境变量都と是ぜ为了给 cgi 脚本きゃくほん调用，接着せっちゃく用よう execl 运行 cgi 程ほど序じょ。

    （9） 在ざい父ちち进程中ちゅう，关闭 cgi_input 的てき读取端はし 和わ cgi_output 的てき写うつし入にゅう端はし，如果 POST 的てき话，把わ POST 数すう据すえ写うつし入にゅう cgi_input，已やめ被ひ重定しげさだ向こう到いた STDIN，读取 cgi_output 的てき管かん道どう输出到いた客きゃく户端，该管道どう输入是ぜ STDOUT。接着せっちゃく关闭所有しょゆう管かん道どう，等とう待子まちこ进程结束。这一部分ぶぶん比ひ较乱，见下图说明あきら：

图 1    管かん道どう初はつ始はじめ状じょう态

图 2  管かん道どう最さい终状态 

    （10） 关闭与浏览器き的てき连接，完成かんせい了りょう一いち次じ HTTP 请求与あずか回かい应，因いん为 HTTP 是ぜ无连接せっ的てき。

以下いか内容ないよう来き自じ源みなもと作者さくしゃ:

This software is copyright 1999 by J. David Blackstone. Permission is granted to redistribute and modify this software under the terms of the GNU General Public License, available at http://www.gnu.org/ .

If you use this software or examine the code, I would appreciate knowing and would be overjoyed to hear about it at jdavidb@sourceforge.net .

This software is not production quality. It comes with no warranty of any kind, not even an implied warranty of fitness for a particular purpose. I am not responsible for the damage that will likely result if you use this software on your computer system.

I wrote this webserver for an assignment in my networking class in 1999. We were told that at a bare minimum the server had to serve pages, and told that we would get extra credit for doing "extras." Perl had introduced me to a whole lot of UNIX functionality (I learned sockets and fork from Perl!), and O'Reilly's lion book on UNIX system calls plus O'Reilly's books on CGI and writing web clients in Perl got me thinking and I realized I could make my webserver support CGI with little trouble.

Now, if you're a member of the Apache core group, you might not be impressed. But my professor was blown over. Try the color.cgi sample script and type in "chartreuse." Made me seem smarter than I am, at any rate. :)

Apache it's not. But I do hope that this program is a good educational tool for those interested in http/socket programming, as well as UNIX system calls. (There's some textbook uses of pipes, environment variables, forks, and so on.)

One last thing: if you look at my webserver or (are you out of mind?!?) use it, I would just be overjoyed to hear about it. Please email me. I probably won't really be releasing major updates, but if I help you learn something, I'd love to know!

Happy hacking!

                               J. David Blackstone