MasteringVFP/17/1
出自VFP Wiki
小 |
小 (→實作過程系列文章) |
||
(26個中途的修訂版本沒有顯示) | |||
第1行: | 第1行: | ||
+ | [[category:MasteringVFP/17]] | ||
+ | [[Category:VFPCGI]] | ||
===VFP與CGI=== | ===VFP與CGI=== | ||
+ | ====簡介==== | ||
在網址上有時候會看到類似 | 在網址上有時候會看到類似 | ||
<b>http://www.your_site.com/xxx.exe?xxx=yyy</b> | <b>http://www.your_site.com/xxx.exe?xxx=yyy</b> | ||
的網址,那並不是一個常見的 .exe, 而是實做了 CGI 介面的 .exe. | 的網址,那並不是一個常見的 .exe, 而是實做了 CGI 介面的 .exe. | ||
- | 事實上,VFP在配合Win32 API 之後,是可以實做出CGI介面的,關鍵的API在於 ReadFile | + | 甚麼是 CGI ?? CGI 的全名是 Common Gateway Interface,也就是一種介面。只要你的應用程式實做此一介面,Web server 就可以據此與你的應用程式溝通。 |
+ | |||
+ | ====原理==== | ||
+ | CGI是怎麼與Web Server溝通的呢?HTML 裡面有所謂的 Form,你可以指定 Form 的 method 為 POST 或 GET。POST 與 GET 決定了 CGI 該怎麼去取得資料;如果是 POST,那麼 Web server 會把這些資料放到 STDIN (標準輸入資料流)去,你的 CGI 就應該使用標準輸入函數去讀取這些資料;如果是 GET,Web server 會把這些資料放到名為 QUERYSTRING 的環境變數裡,於是你需要使用取環境變數的函數來取得這些資料。至於輸出的部份,統一都是輸入到 STDOUT (標準輸出資料流)。 | ||
+ | |||
+ | 之後的所有技術都與 CGI 脫不了關係,都是以 CGI 為基礎發展出來的。所以會了 CGI 之後,後面也會了一半。 | ||
+ | |||
+ | 事實上,VFP在配合Win32 API 之後,是可以實做出CGI介面的,關鍵的API在於 ReadFile / GetENV / WriteFile 這幾個API。ReadFile 可以讀取 STDIN (標準輸入資料流),GetENV 則可以取得環境變數,於是你已經可以取得 POST 或 GET 的資料。WriteFile 可以輸出到 STDOUT (標準輸出資料流)。 | ||
在網路上可以搜索到不少資料: | 在網路上可以搜索到不少資料: | ||
- | *用VB開發標準CGI程序 _ | + | *用VB開發標準CGI程序 _ 安全中國http://anqn.com/dev/vb/a/2005-08-30/a52663.shtml |
- | *Google 網上論壇 : microsoft.public.fox.programmer.exchange | + | *Google 網上論壇 : microsoft.public.fox.programmer.exchange http://groups.google.com.tw/group/microsoft.public.fox.programmer.exchange/browse_thread/thread/51297d29e4c3e99c/2147429131fd30e5%232147429131fd30e5?sa=X&oi=groupsr&start=0&num=3 |
第二個連結裡面有 VFP 的 sample. | 第二個連結裡面有 VFP 的 sample. | ||
第15行: | 第25行: | ||
這也是後來為甚麼 script 會大為盛行的原因,因為他們所需要的資源較少,處理以及除錯上也較為方便,不過基礎原理還是一樣的。 | 這也是後來為甚麼 script 會大為盛行的原因,因為他們所需要的資源較少,處理以及除錯上也較為方便,不過基礎原理還是一樣的。 | ||
+ | |||
+ | ====簡易範例==== | ||
+ | <pre> | ||
+ | * | ||
+ | * Main.prg | ||
+ | * | ||
+ | |||
+ | SET PROCEDURE TO cgilib | ||
+ | |||
+ | LOCAL oResponse | ||
+ | oResponse = CREATEOBJECT( "RESPONSE" ) | ||
+ | oResponse.Headers.Add( "text/plain", "Content-type" ) | ||
+ | oResponse.Headers.Add( "us-ascii", "charset" ) | ||
+ | oResponse.Write( "<p>Hello world!</p>") | ||
+ | </pre> | ||
+ | <pre> | ||
+ | * | ||
+ | * cgilib.prg | ||
+ | * | ||
+ | DEFINE CLASS RESPONSE as Custom | ||
+ | bDirty = .F. | ||
+ | bHeaderOut = .F. | ||
+ | ADD OBJECT Headers AS collection | ||
+ | |||
+ | PROCEDURE Init | ||
+ | CREATE CURSOR outputCache ( outLine varchar(254) ) | ||
+ | ENDPROC | ||
+ | |||
+ | PROCEDURE destroy | ||
+ | IF this.bDirty == .T. | ||
+ | this.flush() | ||
+ | ENDIF | ||
+ | USE IN outputCache | ||
+ | ENDPROC | ||
+ | |||
+ | PROCEDURE Write | ||
+ | LPARAMETERS theHtml | ||
+ | LOCAL lcOutput | ||
+ | |||
+ | INSERT INTO outputCache values( theHtml ) | ||
+ | this.bDirty = .t. | ||
+ | RETURN | ||
+ | ENDPROC | ||
+ | |||
+ | HIDDEN PROCEDURE InternalWrite | ||
+ | LPARAMETER lcOutput | ||
+ | |||
+ | DECLARE INTEGER GetStdHandle in Win32API integer nHandleType | ||
+ | declare integer WriteFile in Win32API integer hFile, string @ cBuffer,; | ||
+ | integer nBytes, integer @ nBytes2, integer @ nBytes3 | ||
+ | |||
+ | LOCAL lnOutHandle | ||
+ | LOCAL lnBytesWritten | ||
+ | LOCAL lnOverLappedIO | ||
+ | |||
+ | lnOutHandle=GetStdHandle(-11) | ||
+ | lnBytesWritten=0 | ||
+ | lnOverLappedIO=0 | ||
+ | WriteFile(lnOutHandle, @lcOutput, len(lcOutput), @lnBytesWritten, @lnOverLappedIO) | ||
+ | ENDPROC | ||
+ | |||
+ | PROCEDURE flushHeader | ||
+ | LOCAL lcDefaultOutput | ||
+ | LOCAL lcOutput | ||
+ | LOCAL lcKey | ||
+ | local i | ||
+ | |||
+ | lcDefaultOutput="HTTP/1.0 200 OK"+chr(13)+chr(10) | ||
+ | lcOutput = "" | ||
+ | |||
+ | FOR i = 1 TO this.Headers.Count | ||
+ | lcKey = this.Headers.GetKey( i ) | ||
+ | IF !EMPTY( lcKey ) THEN | ||
+ | lcOutput = lcOutput + lcKey + ": " + this.Headers.Item(i) + CHR(13) + CHR(10) | ||
+ | ENDIF | ||
+ | NEXT | ||
+ | |||
+ | IF this.Headers.getKey( "Content-type" ) == 0 THEN | ||
+ | lcOutput = lcOutput + "Content-type: text/html"+chr(13)+chr(10) | ||
+ | ENDIF | ||
+ | |||
+ | lcOutput = lcOutput + chr(13)+chr(10) | ||
+ | this.InternalWrite( lcDefaultOutput + lcOutput ) | ||
+ | this.bHeaderOut = .T. | ||
+ | ENDPROC | ||
+ | |||
+ | PROCEDURE flush | ||
+ | IF this.bDirty == .f. then | ||
+ | RETURN | ||
+ | ENDIF | ||
+ | |||
+ | LOCAL lcAlias | ||
+ | LOCAL lcOutput | ||
+ | |||
+ | IF this.bHeaderOut == .F. THEN | ||
+ | this.flushHeader() | ||
+ | ENDIF | ||
+ | |||
+ | lcAlias = ALIAS() | ||
+ | SELECT outputCache | ||
+ | GO top | ||
+ | SCAN | ||
+ | lcOutput = outputCache.outLine | ||
+ | ? lcOutput | ||
+ | this.InternalWrite( lcOutput ) | ||
+ | ENDSCAN | ||
+ | SELECT( lcAlias ) | ||
+ | ENDPROC | ||
+ | ENDDEFINE | ||
+ | </pre> | ||
+ | ====參考資料==== | ||
+ | *[http://www.w3.org/CGI/ CGI - Common Gateway Interface] | ||
+ | *[http://cgi-spec.golux.com/ The Common Gateway Interface - RFC Project Page] | ||
+ | *[http://hoohoo.ncsa.uiuc.edu/cgi/overview.html The Common Gateway Interface] | ||
+ | *[http://rfc.net/rfc2396.html RFC2396] | ||
+ | *[http://ind.ntou.edu.tw/~dada/cgi/ CGI&Perl] | ||
+ | |||
+ | ====實作過程系列文章==== | ||
+ | *[[VFPCGI Day1|VFPCGI的第一天]] | ||
+ | *[[VFPCGI Day2|VFPCGI的第二天]] | ||
+ | *[[VFPCGI Day3|VFPCGI的第三天]] | ||
+ | *[[VFPCGI Day4|VFPCGI的第四天]] | ||
+ | *[[VFPCGI_Day5|VFPCGI的第五天]] | ||
+ | *[[VFPCGI_Day6|VFPCGI的第六天]] | ||
+ | *[[VFPCGI_Day7|VFPCGI的第七天]] | ||
+ | *[[VFPCGI_Day8|VFPCGI的第八天]] | ||
+ | *[[VFPCGI_Day9|VFPCGI的第九天]] | ||
+ | *[[VFPCGI_Day10|VFPCGI的第十天]] | ||
+ | *[[VFPCGI_Day11|VFPCGI的第十一天]] | ||
+ | *[[VFPCGI_Day12|VFPCGI的第十二天]] | ||
+ | *[[VFPCGI_Day13|VFPCGI的第十三天]] | ||
+ | *[[VFPCGI_Day14|VFPCGI的第十四天]] |
在2007年3月23日 (五) 01:31的最新修訂版本
目錄 |
VFP與CGI
簡介
在網址上有時候會看到類似 http://www.your_site.com/xxx.exe?xxx=yyy 的網址,那並不是一個常見的 .exe, 而是實做了 CGI 介面的 .exe.
甚麼是 CGI ?? CGI 的全名是 Common Gateway Interface,也就是一種介面。只要你的應用程式實做此一介面,Web server 就可以據此與你的應用程式溝通。
原理
CGI是怎麼與Web Server溝通的呢?HTML 裡面有所謂的 Form,你可以指定 Form 的 method 為 POST 或 GET。POST 與 GET 決定了 CGI 該怎麼去取得資料;如果是 POST,那麼 Web server 會把這些資料放到 STDIN (標準輸入資料流)去,你的 CGI 就應該使用標準輸入函數去讀取這些資料;如果是 GET,Web server 會把這些資料放到名為 QUERYSTRING 的環境變數裡,於是你需要使用取環境變數的函數來取得這些資料。至於輸出的部份,統一都是輸入到 STDOUT (標準輸出資料流)。
之後的所有技術都與 CGI 脫不了關係,都是以 CGI 為基礎發展出來的。所以會了 CGI 之後,後面也會了一半。
事實上,VFP在配合Win32 API 之後,是可以實做出CGI介面的,關鍵的API在於 ReadFile / GetENV / WriteFile 這幾個API。ReadFile 可以讀取 STDIN (標準輸入資料流),GetENV 則可以取得環境變數,於是你已經可以取得 POST 或 GET 的資料。WriteFile 可以輸出到 STDOUT (標準輸出資料流)。
在網路上可以搜索到不少資料:
- 用VB開發標準CGI程序 _ 安全中國http://anqn.com/dev/vb/a/2005-08-30/a52663.shtml
- Google 網上論壇 : microsoft.public.fox.programmer.exchange http://groups.google.com.tw/group/microsoft.public.fox.programmer.exchange/browse_thread/thread/51297d29e4c3e99c/2147429131fd30e5%232147429131fd30e5?sa=X&oi=groupsr&start=0&num=3
第二個連結裡面有 VFP 的 sample.
實做CGI以後,你需要考量的是當 Request 過多時的問題。當 request 過多的時候,CGI 的效能並不好。因為 web server 在遇到 request CGI 的時候,會為這個 CGI create 一個 process 起來。當同時遇到 1000, 10000, 100000 ....個 request 的時候,web server 就會去 create 1000、10000、100000 ....個 process, 這會拖垮整個 server 的效能!!
這也是後來為甚麼 script 會大為盛行的原因,因為他們所需要的資源較少,處理以及除錯上也較為方便,不過基礎原理還是一樣的。
簡易範例
* * Main.prg * SET PROCEDURE TO cgilib LOCAL oResponse oResponse = CREATEOBJECT( "RESPONSE" ) oResponse.Headers.Add( "text/plain", "Content-type" ) oResponse.Headers.Add( "us-ascii", "charset" ) oResponse.Write( "<p>Hello world!</p>")
* * cgilib.prg * DEFINE CLASS RESPONSE as Custom bDirty = .F. bHeaderOut = .F. ADD OBJECT Headers AS collection PROCEDURE Init CREATE CURSOR outputCache ( outLine varchar(254) ) ENDPROC PROCEDURE destroy IF this.bDirty == .T. this.flush() ENDIF USE IN outputCache ENDPROC PROCEDURE Write LPARAMETERS theHtml LOCAL lcOutput INSERT INTO outputCache values( theHtml ) this.bDirty = .t. RETURN ENDPROC HIDDEN PROCEDURE InternalWrite LPARAMETER lcOutput DECLARE INTEGER GetStdHandle in Win32API integer nHandleType declare integer WriteFile in Win32API integer hFile, string @ cBuffer,; integer nBytes, integer @ nBytes2, integer @ nBytes3 LOCAL lnOutHandle LOCAL lnBytesWritten LOCAL lnOverLappedIO lnOutHandle=GetStdHandle(-11) lnBytesWritten=0 lnOverLappedIO=0 WriteFile(lnOutHandle, @lcOutput, len(lcOutput), @lnBytesWritten, @lnOverLappedIO) ENDPROC PROCEDURE flushHeader LOCAL lcDefaultOutput LOCAL lcOutput LOCAL lcKey local i lcDefaultOutput="HTTP/1.0 200 OK"+chr(13)+chr(10) lcOutput = "" FOR i = 1 TO this.Headers.Count lcKey = this.Headers.GetKey( i ) IF !EMPTY( lcKey ) THEN lcOutput = lcOutput + lcKey + ": " + this.Headers.Item(i) + CHR(13) + CHR(10) ENDIF NEXT IF this.Headers.getKey( "Content-type" ) == 0 THEN lcOutput = lcOutput + "Content-type: text/html"+chr(13)+chr(10) ENDIF lcOutput = lcOutput + chr(13)+chr(10) this.InternalWrite( lcDefaultOutput + lcOutput ) this.bHeaderOut = .T. ENDPROC PROCEDURE flush IF this.bDirty == .f. then RETURN ENDIF LOCAL lcAlias LOCAL lcOutput IF this.bHeaderOut == .F. THEN this.flushHeader() ENDIF lcAlias = ALIAS() SELECT outputCache GO top SCAN lcOutput = outputCache.outLine ? lcOutput this.InternalWrite( lcOutput ) ENDSCAN SELECT( lcAlias ) ENDPROC ENDDEFINE
參考資料
- CGI - Common Gateway Interface
- The Common Gateway Interface - RFC Project Page
- The Common Gateway Interface
- RFC2396
- CGI&Perl