Implement CGI in your httpd
author : Kevin Lynx
Purpose
為我們的http server加入CGI的功能，并不是要讓其成為真正響應(yīng)CGI query功能的web server。正如klhttpd的開發(fā)初衷一樣，
更多的時候我們需要的是一個嵌入式(embeded)的web server。
而加入CGI功能（也許它算不上真正的CGI），則是為了讓我們與client擁有更多的交互能力。我們也許需要為我們的應(yīng)用程序
加入一個具有網(wǎng)頁外觀的界面，也許這才是我的目的。
Brief
CGI，common gateway interface，在我看來它就是一個公共約定。客戶端瀏覽器提交表單(form)操作結(jié)果給服務(wù)器，服務(wù)器
解析這些操作，完成這些操作，然后創(chuàng)建返回信息（例如一個靜態(tài)網(wǎng)頁），返回給瀏覽器。
因為瀏覽器遵循了CGI發(fā)送請求的標(biāo)準(zhǔn)，那么我們所要做的就是解析收到的請求，處理我們自己的邏輯，返回信息給客戶端即可。
Detail...
如果你要獲取CGI的更多信息，你可以在網(wǎng)上查閱相關(guān)信息。如果你要獲取web server對CGI標(biāo)準(zhǔn)的處理方式，我無法提供給你
這些信息。不過我愿意提供我的臆測：
處理CGI請求通常都是由腳本去完成（當(dāng)然也可以用任何可執(zhí)行程序完成）。就我所獲取的資料來看，只要一門語言具備基本的
輸入輸出功能，它就可以被用作CGI腳本。瀏覽器以key-value的形式提交query string，一個典型的以GET方式提交query string的
URL類似于：http://host/cgi-bin/some-script.cgi?name=kevin+lynx&age=22。不必拘泥于我上句話中出現(xiàn)的一些讓你產(chǎn)生問號的
名詞。我可以告訴你，這里舉出的URL（也許更準(zhǔn)確的說法是URI）中問號后面的字符串即為一個query string。
我希望你看過我的上一篇草文<實(shí)現(xiàn)自己的http server>，你應(yīng)該知道一個典型的GET請求時怎樣的格式，應(yīng)該知道什么是initial
line，應(yīng)該知道HTTP請求有很多method，例如GET、POST、HEAD等。
一個CGI請求通常使用GET或POST作為其request method。對于一個GET類型的CGI請求，一個典型的request類似于：
GET /cgi-bin/some-script.cgi?name=kevin+lynx&age=22 HTTP/1.1
other headers...
...
我上面舉例的那個URL則可能出現(xiàn)在你的瀏覽器的地址欄中，它對我們不重要。
而對于POST類型的CGI請求呢？query string只是被放到了optional body里，如：
POST /cgi-bin/some-script.cgi HTTP/1.1
other heads...
...
name=kevin+lynx&age=22
不管我說到什么，我希望你不要陷入概念的泥潭，我希望你能明確我在brief里提到的what can we do and how to do。
How about the web browser ?
我總是想引領(lǐng)你走在實(shí)踐的路上(on the practice way)。作為一個程序員，你有理由自負(fù)，但是你沒任何理由小覷任何一個
編程問題。打開你的編譯器，現(xiàn)在就敲下main。
so，我們需要知道如何利用我們的瀏覽器，讓我們更為順手地實(shí)踐我們的想法。
你也許會寫：<html><head><title>HTML test</title></head><body>it's a html</body></html>這樣的HTML標(biāo)記語言。但是
這沒有利用上CGI。check out the url in the reference section and learn how to write FORMs.
這個時候你應(yīng)該明白：
<html>
<head>
<title>CGI test</title>
</head>
<body>
<FORM ACTION="./cgi-bin/test.cgi">
<INPUT TYPE="text" NAME="name" SIZE=20 VALUE="Your name">
</FORM>
</body>
</html>
加入<FORM>來添加表單，加入<INPUT TYPE="text"加一個edit box控件。那么當(dāng)你在里面輸入名字按下回車鍵時，瀏覽器將整理
出一個CGI query string發(fā)給服務(wù)器。
我希望你能在瀏覽器里看到以問號打頭的key-value形式的字符串。
So here we go...
在你自己已有的http server的代碼基礎(chǔ)上，讓瀏覽器來請求一個包含F(xiàn)ORM的網(wǎng)頁，例如以上我舉例的html。當(dāng)瀏覽器將請求發(fā)
給服務(wù)器的時候，看看服務(wù)器這邊收到的request。即使你猜到了什么，我也建議你看看，這樣你將看到一個真正的CGI query是怎么
樣的。
so you know，CGI請求本質(zhì)上也就是一連串的key-value字符串。真正的http server會將這些字符串傳給CGI腳本。腳本只需要
輸出處理結(jié)果信息到標(biāo)準(zhǔn)輸出，服務(wù)器就會收集這些輸出然后發(fā)給客戶端。
你也許在揣摩，我們的httpd如何地exec一個外部程序或腳本，如何等待腳本執(zhí)行完（需不需要異步？），然后如何收集標(biāo)準(zhǔn)輸
出上的信息，然后是否需要同步地將這些信息送往客戶端。
這很沒必要。如果我們的http server真的只是被embeded到其他程序的。我們只需要將query的邏輯處理交給上層模塊即可。
What's the next..
現(xiàn)在你知道什么是CGI query string，你也許稍微思考下就知道接下來你該如何去做(if you smart enough)。記住我們的目標(biāo)，
只是解析CGI query string，然后處理相關(guān)邏輯，返回處理結(jié)果信息給客戶端。
所以接下來，呃，接下來，everything is up to you：分析那些惱人的字符串，將其從&的間隔中整理出來，得到一個key-value
的表，將這個表給你的上層模塊，上層模塊根據(jù)query scritp決定執(zhí)行什么邏輯，根據(jù)這個表獲取需要的參數(shù)，處理，將結(jié)果格式
化為HTML之類的東西，then response。
就這么簡單。
Example...
同樣，我提供了源碼，從而證明我不是紙上談兵夸夸其談。我希望我公開源碼的習(xí)慣能受到你的贊同。
下載帶CGI的http server.
Reference:
http://hoohoo.ncsa.uiuc.edu/cgi/ (獲取服務(wù)器需要做的)
http://www.ietf.org/rfc/rfc3875 (rfc cgi)
http://www.cmis.brighton.ac.uk/~mas/mas/courses/html/html2.html (學(xué)會寫帶FORM的HTML)