Ruby CGI 編程

Ruby 是一門通用的語言，不僅僅是一門應用於WEB開發的語言，但 Ruby 在WEB應用及WEB工具中的開發是最常見的。

使用Ruby您不僅可以編寫自己的SMTP伺服器，FTP程序，或Ruby Web伺服器，而且還可以使用Ruby進行CGI程式設計。

接下來，讓我們花點時間來學習Ruby的CGI編輯。

網頁瀏覽

為了更好的了解CGI是如何運作的，我們可以從在網頁上點擊一個連結或URL的流程：

1、使用你的瀏覽器存取URL並連接到HTTP web 伺服器。
2、網路伺服器接收到請求資訊後會解析URL，並尋找存取的檔案在伺服器上是否存在，如果存在傳回檔案的內容，否則傳回錯誤訊息。
3、瀏覽器從伺服器上接收訊息，並顯示接收的檔案或錯誤訊息。

CGI程式可以是 Ruby 腳本，Python 腳本，PERL 腳本，SHELL 腳本，C 或 C++ 程式等。

CGI架構圖

Web伺服器支援及設定

在你進行CGI程式設計前，確保您的Web伺服器支援CGI及已經配置了CGI的處理程序。

Apache 支援CGI 設定：

設定好CGI目錄：

ScriptAlias /cgi-bin/ /var/www/cgi-bin/

所有的HTTP伺服器執行CGI程式都儲存在一個預先設定好的目錄。這個目錄被稱為CGI目錄，並且按照慣例，它被命名為/var/www/cgi-bin目錄。

CGI檔案的副檔名為.cgi，Ruby 也可以使用 .rb 副檔名。

預設情況下，Linux伺服器配置在運行的cgi-bin目錄中為/var/www。

如果你想指定其他運行CGI腳本的目錄，可以修改httpd.conf配置文件，如下所示：

<Directory "/var/www/cgi-bin">
   AllowOverride None
   Options +ExecCGI
   Order allow,deny
   Allow from all
</Directory>

在AddHandler 中添加.rb 後綴，這樣我們就可以訪問. rb 結尾的Ruby 腳本檔：

AddHandler cgi-script .cgi .pl .rb

編寫CGI 腳本

最基本的Ruby CGI 程式碼如下所示：

#!/usr/bin/ruby

puts "Content-type: text/html\n\n"
puts "<html><body>This is a test</body></html>"

你可以將程式碼保持到test.cgi 檔案中，上次到伺服器並賦予足夠權限，即可作為CGI 腳本執行。

如果你站的地址為http://www.example.com/ ，即可使用http://www.example.com/test.cgi 存取程序，輸出結果為： "This is a test."。

瀏覽器存取該網址後，Web 伺服器會在網站目錄下找到 test.cgi文件，然後透過Ruby解析器來解析腳本程式碼並存取HTML文件。

使用 cgi.rb

Ruby 可以呼叫 CGI 函式庫來寫更複雜的CGI腳本。

以下程式碼呼叫了 CGI 函式庫來建立一個腳本的CGI腳本。

#!/usr/bin/ruby

require 'cgi'

cgi = CGI.new
puts cgi.header
puts "<html><body>This is a test</body></html>"

以下程式碼中，建立了CGI 物件並列印頭部資訊。

表單處理

使用CGI庫可以透過兩種方式取得表單提交（或URL中的參數）的數據，例如URL：/cgi-bin/test.cgi?FirstName=Zara&LastName=Ali。

你可以使用CGI#[] 來直接取得參數FirstName和LastName：

#!/usr/bin/ruby

require 'cgi'
cgi = CGI.new
cgi['FirstName'] # =>  ["Zara"]
cgi['LastName']  # =>  ["Ali"]

另外一種取得表單資料的方法：

#!/usr/bin/ruby

require 'cgi'
cgi = CGI.new
h = cgi.params  # =>  {"FirstName"=>["Zara"],"LastName"=>["Ali"]}
h['FirstName']  # =>  ["Zara"]
h['LastName']   # =>  ["Ali"]

以下程式碼用於檢索所有的鍵值：

#!/usr/bin/ruby

require 'cgi'
cgi = CGI.new
cgi.keys         # =>  ["FirstName", "LastName"]

如果表單包含了多個相同名稱的字段，則該相同字段的值將保存在數組中。

以下實例中，指定表單中三個相同的欄位"name"，值分別為"Zara", "Huma" 和"Nuha":

#!/usr/bin/ruby

require 'cgi'
cgi = CGI.new
cgi['name']        # => "Zara"
cgi.params['name'] # => ["Zara", "Huma", "Nuha"]
cgi.keys           # => ["name"]
cgi.params         # => {"name"=>["Zara", "Huma", "Nuha"]}

注意：Ruby 會自動判斷GET 和POST 方法，所以無需對兩種方法區別對待。

以下是相關的HML程式碼：

<html>
<body>
<form method="POST" action="http://www.example.com/test.cgi">
First Name :<input type="text" name="FirstName" value="" />
<br />
Last Name :<input type="text" name="LastName" value="" /> 

<input type="submit" value="Submit Data" />
</form>
</body>
</html>

建立Form 表單和HTML

CGI 包含了大量的方法來建立HTML，每個HTML標籤都有相對應的方法。在使用這些方法前，比必須透過 CGI.new 來建立 CGI 物件。

為了讓標籤的嵌套更加的簡單，這些方法將內容作為了程式碼區塊，程式碼區塊將傳回字串作為標籤的內容。如下所示：

#!/usr/bin/ruby

require "cgi"
cgi = CGI.new("html4")
cgi.out{
   cgi.html{
      cgi.head{ "\n"+cgi.title{"This Is a Test"} } +
      cgi.body{ "\n"+
         cgi.form{"\n"+
            cgi.hr +
            cgi.h1 { "A Form: " } + "\n"+
            cgi.textarea("get_text") +"\n"+
            cgi.br +
            cgi.submit
         }
      }
   }
}

字串轉義

當你在處理URL 中的參數或HTML 表單資料時，需要對指定的特殊字元進行轉義，如：引號（"）,反斜線(/)。

Ruby CGI 物件提供了CGI.escape 和CGI.unescape 方法來處理這些特殊字元的轉義：

#!/usr/bin/ruby

require 'cgi'
puts CGI.escape(Zara Ali/A Sweet & Sour Girl")

以上程式碼執行結果如下：

#!/usr/bin/ruby

require 'cgi'
puts CGI.escape(Zara Ali/A Sweet & Sour Girl")

另一組實例：

#!/usr/bin/ruby

require 'cgi'
puts CGI.escapeHTML('<h1>Zara Ali/A Sweet & Sour Girl</h1>')