Ruby CGI 編程

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

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

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

網頁流覽

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

  • 1、使用你的流覽器訪問URL並連接到HTTP web 伺服器。
  • 2、Web伺服器接收到請求資訊後會解析URL，並查找訪問的檔在伺服器上是否存在，如果存在返回檔的內容，否則返回錯誤資訊。
  • 3、流覽器從伺服器上接收資訊，並顯示接收的檔或者錯誤資訊。

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

CGI架構圖

cgiarch

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>')

以上代碼執行結果如下：

&lt;h1&gt;Zara Ali/A Sweet & Sour Girl&lt;/h1&gt;'

CGI 類中常用的方法

以下是Ruby中完整的CGI類的相關方法

Cookies 和 Sessions