下面是一個簡單的CGI程序,它將HTML中Form的信息直接輸出到We b瀏覽器。 # include # include main() { int i , n ; PRintf (″Content type: text/plain/n/n″); n=0; if(getenv(″CONTENT-LENGTH″)) n=atoi(getenv(CONTENT-LENGTH″)); for (i=0;i putchar(getchar()); putchar (′/n′); fflush(stdout); }
下面對此程序作一下簡要的分析。 prinft (″Content type :text/plain/n/n″); 此行通過標準輸出將字符串″Content type :text/plain/n/n″傳送給Web服務器。它是一個MIME頭信息,它告訴Web服務器隨后的輸出是以純ASCII文本的形式。請注重在這個頭信息中有兩個新行符,這是因為Web服務器需要在實際的文本信息開始之前先看見一個空行。 if (getenv(″CONTENT-LENGTH″)) n=atoi (getenv(″CONTENT-LENGTH″)); 此行首先檢查環境變量CONTENT-LENGTH是否存在。Web服務器在調用使用POST方法的CGI程序時設置此環境變量,它的文本值表示Web服務器傳送給CGI程序的輸入中的字符數目,因此我們使用函數atoi() 將此環境變量的值轉換成整數,并賦給變量n。請注重Web服務器并不以文件結束符來終止它的輸出,所以假如不檢查環境變量CONTENT-LENGTH,CGI程序就無法知道什么時候輸入結束了。 for (i=0;i putchar(getchar()); 此行從0循環到(CONTENT-LENGTH-1)次將標準輸入中讀到的每一個字符直接拷貝到標準輸出,也就是將所有的輸入以ASCII的形式回送給Web服務器。 通過此例,我們可將CGI程序的一般工作過程總結為如下幾點。 1.通過檢查環境變量CONTENT-LENGTH,確定有多少輸入; 2.循環使用getchar()或者其他文件讀函數得到所有的輸入; 3.以相應的方法處理輸入; 4.通過″Contenttype:″頭信息,將輸出信息的格式告訴Web服務器; 5.通過使用printf()或者putchar()或者其他的文件寫函數,將輸出傳送給Web服務器。 總之,CGI程序的主要任務就是從Web服務器得到輸入信息,進行處理,然后將輸出結果再送回給Web服務器。
三、From輸入的分析和解碼 1.分析名字/值對 當用戶提交一個HTML Form時,Web瀏覽器首先對Form中的數據以名字/值對的形式進行編碼,并發送給Web服務器,然后由Web服務器傳遞給CGI程序。 其格式如下: name1=value1&name2=value2&name3=value3&name4=value4&... 其中名字是Form中定義的INPUT、SELECT或TEXTAREA等標置(Tag)名字,值是用戶輸入或選擇的標置值。這種格式即為URL編碼,程序中需要對其進行分析和解碼。要分析這種數據流,CGI程序必須首先將數據流分解成一組組的名字/值對。這可以通過在輸入流中查找下面的兩個字符來完成。 每當找到字符=,標志著一個Form變量名字的結束;每當找到字符& ,標志著一個Form變量值的結束。請注重輸入數據的最后一個變量的值不以&結束。 一旦名字/值對分解后,還必須將輸入中的一些非凡字符轉換成相應的ASCII字符。這些非凡字符是: +:將+轉換成空格符; %xx:用其十六進制ASCII碼值表示的非凡字符。根據值xx將其轉換成相應的ASCII字符。 對Form變量名和變量值都要進行這種轉換。下面是一個對Form數據進行分析并將結果回送給Web服務器的CGI程序。 #include #include #include int htoi(char *); main() { int i,n; char c; printf (″Contenttype: text/plain/n/n″); n=0; if (getenv(″CONTENT-LENGTH″)) n=atoi(getenv(″CONTENT-LENGTH″)); for (i=0; i 當發現字符為&時,意味著一個名字/值對的結束,程序輸出一個空行;當發現字符為+時,將它轉換成空格; 當發現字符為%時,意味著一個兩字符的十六進制值的開始,調用htoi()函數將隨后的兩個字符轉換為相應的ASCII字符;當發現字符為=時,意味著一個名字/值對的名字部分的結束,并將它轉換成字符:。最后將轉換后的字符輸出給Web服務器。 四、產生HTML輸出 CGI程序產生的輸出由兩部分組成:MIME頭信息和實際的信息。兩部分之間以一個空行分開。我們已經看到怎樣使用MIME頭信息″Content type :text/plain/n/n″和printf()、put char()等函數調用來輸 出純ASCII文本給Web服務器。實際上,我們也可以使用MIME頭信息″Content type :text/html/n/n″來輸出HTML源代碼給Web服務器。請注重任何MIME頭信息后必須有一個空行。一旦發送這個MIME頭信息給We b服務器后,Web瀏覽器將認為隨后的文本輸出為HTML源代碼,在HTML源代碼中可以使用任何HTML結構,如超鏈、圖像、Form,及對其他CGI程 序的調用。也就是說,我們可以在CGI程序中動態產生HTML源代碼輸出 ,下面是一個簡單的例子。 #include #include main() { printf(″Contenttype:text/html/n/n″); printf(″<html>/n″); printf(″<head><title>An HTML Page From a CGI</title></head>/n″); printf(″<body><br>/n″); printf(″<h2> This is an HTML page generated from with i n a CGI program.. .</h2>/n″); printf(″<hr><p>/n″); printf(″<a href="../output.html#two"><b> Go back to output.html page </b></a>/n″); printf(″</body>/n″); printf(″</html>/n″); fflush(stdout); } 上面的CGI程序簡單地用printf()函數來產生HTML源代碼。請注重在輸出的字符串中假如有雙引號,在其前面必須有一個后斜字符/, 這是因為整個HTML代碼串已經在雙引號內,所以HTML代碼串中的雙引號符必須用一個后斜字符/來轉義。 五、結束語 本文具體分析了用C語言進行CGI程序設計的方法、過程和技巧。C語言的CGI程序雖然執行速度快、可靠性高,但是相對于Perl語言來說,C語言缺乏強有力的字符串處理能力,因此在實際應用中,應根據需 要和個人愛好來選擇合適的CGI程序設計語言。