A HA! 心情雜物間

...CGI 是 Common Gateway Interface 的縮寫，它可以連結網路主機端與瀏覽器端，使其能夠作檔案存取等動作的一種介面，CGI 程式就是可達成前述動作的程式，這是一種通稱而不是指某種特定的程式，CGI 程式可以使用多種電腦語言來撰寫，依據作業平台的不同最常見的有 C、C++、Perl、PHP、TCL、JAVA、VB...等。

......

在網路上較常見的 CGI 程式多數是使用 Perl 語言撰寫的，因為它幾乎可說是專門為了撰寫 CGI 程式而量身打造的一種電腦語言，而且可使用的平台也較廣，如果是使用 VB 來撰寫 CGI 程式，那就只能在 Windows 平台上執行，若使用 C 語言來撰寫 CGI 程式，那麼就必須要在不同的作業平台上重新編譯過，否則是不能正常運作的。

Perl 語言是一種解譯式 (或稱直譯式) 的電腦語言，因此是以原始碼的型態散播的，它的語法基本上與 C 極為類似，許多學習 CGI 程式的人都是由觀摩他人撰寫的 Perl 程式，進而修改成自己想要的介面或功能來入門的，Perl 比較特別的是正規表示式 (Regular Expressions)，功能非常非常的強大，但是因為是以符號所組成的一些處理規則，所以常常有初學者因為懶得查閱文件所以被它給打敗，如果您能在參考他人的程式時勤查文件來對照，其實學習起來並不難！

但是網路上雖然較常看到以 Perl 語言所撰寫的 CGI 程式，但是 CGI 與 Perl 並不等於是同義字，請不要將名詞弄混了，如果是請教有關 Perl 語言所撰寫的程式問題，就寫明請教的是有關 Perl 語言的語法或流程等，"CGI" 與 "CGI 程式" 也一樣不等於是同義字，"CGI" 一詞僅指 "通訊協定"，而 "CGI 程式" 才是指 "程式"。

......

什麼是 CGI ？ 什麼是 CGI 程式？

CGI 是 Common Gateway Interface 的簡稱，一般中譯為：共通閘道介面。

Common 是指共通的、不限於一種作法的意思，在這裡指的是語言的獨立性，換言之，可以用任何一種程式語言來實作。

Gateway 是說伺服器的應用能力是經由擴充得到的，它將查詢等要求交由外部程式處理，處理完了之後，再將結果傳回。

Interface 是指一種介面的意思，符合此一介面標準，便可以輕鬆地製作外部程式，而無需去擔心或處理低階的問題。

......

CGI 就是提供給外部程式的一種介面，只要符合此一介面標準，程式設計師便可以輕鬆地使用該平台上支援的任何一種程式語言來撰寫外部程式，於是我們說：凡是符合 CGI 介面標準的外部程式，就稱之為 CGI 程式。

撰寫 CGI 程式，常見的語言有 Perl、Python、C、C++、VB，甚至某些 UNIX 中的 shell script 都有人使用。

我們可以這樣來看待 CGI 以及 CGI 程式：

CGI 程式是 WEB 伺服器應用能力的擴充(Extension)，而 CGI 則是此一擴充能力的介面，熟悉瞭解此一介面的原理及運作方式，我們便可以為 WEB 伺服器建立即時互動的能力，以滿足客戶端的要求。

......CGI程式可以根據使用者輸入的要求自動產生HTML格式的資料。因為輸入資料是由WWW server負責接收，並非CGI程式本身，故得找出一個有效率的方法，來做使用者輸入參數和產生HTML文件程式間的溝通工作。 CGI本身制訂的標準有提到可以藉由環境變數來達成這個目的，而且CGI程式也有能力取得現存在各類資料庫裡的資料。這就是為什麼我們稱之為Common Gateway Interface，因為CGI程式通常就像橋樑或閘道一般，溝通著非WWW系統和WWW server (這和下面所說的Web server、HTTP server是一樣的，都是指一個架有HTTPd的伺服器)。

......一部Web server上一定會跑起HTTPd，這是HTTP的server程式(daemon)。由於HTTPd牽涉到系統設定問題，所以除非你是系統管理者或是自己架一台server跑起HTTPd，否則一般使用者是沒有權跑自己寫的CGI程式的。不過現在另外有個程式叫CGI wrap，它可以透過一種特殊的方法讀取userhome/www/cgi-bin裡的CGI程式，並且以使用者的身份來執行這個CGI程式，所以不虞有被破站的危險。

......使用者用瀏覽器link到一個CGI程式時，瀏覽器會透過HTTP這個通訊協定，送出一個請求(require)給遠端(remote)的Web server，Web server就會跑一個HTTPd process，這個process會去找指定的目錄下有沒有這個CGI程式，如果有的話HTTPd會啟動一個child process來跑這個CGI程式，也因此繼承了HTTPd所有的環境變數設定。這也就是說使用者所輸入的要求會經由HTTP通訊協定傳送到Web server的HTTPd，再經由環境變數或標準輸入裝置(STDIN)傳遞給CGI程式。

...The user agent requests the name of an entry; the server will retrieve the source of that entry's page (if one exists), transform it into HTML, and send the result back to the browser or prompt the user to create it. ...

From the Web server's point of view, certain locators, e.g. http://www.example.com/wiki.cgi, are defined as corresponding to a program to execute via CGI. When a request for the URL is received, the corresponding program is executed.

......還記得HTML語法中有個<FORM>標籤嗎? 這就是CGI程式主要應用的地方。當你按下submit按鈕後，瀏覽器會將你填好的資料傳送到WWW server上去，若HTTPd發現這是一個CGI request，就會藉由CGI去呼叫指定的程式，並建立起互相溝通的管道。第一種可互相溝通的管道就是環境變數：由於CGI程式是由HTTPd所呼叫而產生的一個子行程(child process)，所以CGI程式繼承了HTTPd所有的環境變數，因此也得到由client端的瀏覽器傳過來的一些資訊。

......

HTTPd不但將自己的環境變數傳給CGI程式，它還將CGI程式的標準輸入、輸出(STDIN、STDOUT)重新導向，使得HTTPd能將<FORM>裡面的資料藉由STDIN傳遞給CGI程式，而CGI程式也能藉由STDOUT將程式執行結果傳遞給HTTPd show在瀏覽器上。這就是CGI所提供的第二個溝通管道。

還記得<FORM>標籤有個method屬性，它有二種值：get和post，就分別代表著上述二種溝通管道： method=get是藉由環境變數來傳遞資料，一旦指定了這種方法，瀏覽器會將你填入<FORM>裡的資料附加在action屬性所指定的CGI程式名稱後面，並以"?"隔開，當HTTPd收到這個request後會將"?"後面的字串存放在QUERY_STRING這個環境變數中，於是CGI程式就可以透過這個環境變數取得<FORM>裡面的資料了。

但是，環境變數的大小是有一定的限制的，當需要傳送的資料量大時，儲存環境變數的空間可能會不足，造成資料接收不完全，甚至無法執行CGI程式。因此後來又發展出另外一種方法：method=post，也就是利用I/O重新導向的技巧，讓CGI程式可以藉由STDIN和STDOUT直接跟瀏覽器溝通。當我們指定用這種方法傳遞<FORM>裡面的資料時，HTTPd收到資料後會先放在一塊輸入緩衝區中，並且將資料的大小記錄在CONTENT_LENGTH這個環境變數，然後呼叫CGI程式並將CGI程式的STDIN指向這塊緩衝區，於是我們就可以很順利的透過STDIN和環境變數CONTENT_LENGTH得到所有的資料，再沒有資料大小的限制了。 

Microsoft Internet Explorer has a maximum uniform resource locator (URL) length of 2,083 characters. Internet Explorer also has a maximum path length of 2,048 characters. This limit applies to both POST request and GET request URLs.

If you are using the GET method, you are limited to a maximum of 2,048 characters, minus the number of characters in the actual path.

However, the POST method is not limited by the size of the URL for submitting name/value pairs. These pairs are transferred in the header and not in the URL.

 #! /usr/bin/perl     
# 上面這一列用來指出 perl 的路徑，注意：一定要是第一列喔！
# 第二列開始，若有出現 # 表示該列為註解，Perl 將不會執行它

# 這是 MIME 表頭，用來告訴瀏覽器要送出的資料型態是什麼？
# 一定要寫出這一行，否則會出現 Error 500 錯誤
# 注意：每列命令用 ; 做為結束！
print "Content-type:text/html\n\n";

# 接下來印出欲顯示的網頁內容
print "<html><head><title>Hello CGI!</title></head>";

print "<body bgcolor='white'>";

print "<h1>Hello, world!!</h1>";

print "</body></html>";　

 #include <iostream.h>

void main()
{
          // Every CGI script must first output a content-type header
          // The two newlines following the header tells the server 
          // where the headers end and where the data begins.
          cout << "Content-type: text/plain" << endl << endl;
  
          // output plaintext
          cout << "Hello, World!";
}

 #include <iostream.h>

void main()
{
          cout << "Content-type: text/html" << endl << endl
          << "<html>" << endl
          << "<head>" << endl
          << "<title>CGI Test</title>" << endl
          << "</head>" << endl
          << "<body>" << endl
          << "<h1><em>" << endl
          << "Hello, World!" << endl
           << "</em></h1>" << endl
          << "</body>" << endl
          << "</html>";
}

 In order to set up a C program as a CGI script, it needs to be turned into a binary executable program. This is often problematic, since people largely work on Windows whereas servers often run some version of UNIX or Linux. The system where you develop your program and the server where it should be installed as a CGI script may have quite different architectures, so that the same executable does not run on both of them.

......

You need to compile and load your C program on the server (or, in principle, on a system with the same architecture, so that binaries produced for it are executable on the server too).

......