Ruby CGI 程式設計

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="https://www.big2gb.com/cn2tw0.php?url=https://www.itread01.com/ruby/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類的相關方法

  • Ruby CGI - 標準 CGI 庫相關方法

Cookies 和 Sessions

  • Ruby CGI Cookies - 如何處理 CGI Cookies.
  • Ruby CGI Sessions - 如何處理 CGI sessions.