Ruby CGI 會話


CGI::Session 可以為使用者和CGI環境保存持久的會話狀態,會話使用後需要關閉,這樣可以保證資料寫入到儲存當中,當會話完成後,您需要刪除該資料。

#!/usr/bin/ruby

require 'cgi'
require 'cgi/session'
cgi = CGI.new("html4")

sess = CGI::Session.new( cgi, "session_key" => "a_test",
                              "prefix" => "rubysess.")
lastaccess = sess["lastaccess"].to_s
sess["lastaccess"] = Time.now
if cgi['bgcolor'][0] =~ /[a-z]/
  sess["bgcolor"] = cgi['bgcolor']
end

cgi.out{
  cgi.html {
    cgi.body ("bgcolor" => sess["bgcolor"]){
      "The background of this page"    +
      "changes based on the 'bgcolor'" +
      "each user has in session."      +
      "Last access time: #{lastaccess}"
    }
  }
}

造訪 "/cgi-bin/test.cgi?bgcolor=red" 將會跳到指定背景顏色的頁面。

會話資料存在在伺服器的暫存檔案目錄中,prefix 參數指定了會話的前綴,並將作為暫存檔案的前綴。這樣你在伺服器上可以輕鬆的識別不同的會話臨時檔案。


CGI::Session 類別

CGI::Session 保持了使用者與 CGI 環境的持久狀態。 會話可以在記憶體中,也可以在硬碟上。

類別方法

Ruby 類別Class CGI::Session 提供了簡單的方法來建立session:

CGI::Session::new( cgi[, option])

啟用一個新的CGI 會話並傳回對應的CGI:: Session 物件。選項可以是可選的哈希,可以是以下值:

  • session_key: 鍵名保存會話 預設為 _session_id。

  • session_id:  唯一的會話 ID。自動產生

  • new_session: 如果為true,為目前會話建立一個新的Session id。 如果為 false, 透過 session_id 使用已存在的 session 標識。 如果省略該參數,如果可用則使用現有的會話,否則建立一個新的。

  • database_manager: 用來保存 sessions 的類,可以是 CGI::Session::FileStore or CGI::Session::MemoryStore。預設為 FileStore。

  • tmpdir:  對於 FileStore, 為 session 的錯誤儲存目錄。

  • prefix: 對於 FileStore, 為 session 檔案的前綴。

實例化方法

序號方法描述
1[ ]
傳回給定key 的值。查看實例。
2[ ]=
設定給定 key 的值。 查看實例。
3delete
呼叫底層資料庫管理的刪除方法。對於  FileStore, 刪除包含 session 的實體檔案。 對於 MemoryStore, 從記憶體中移除 session 資料。
4update
#呼叫底層資料庫管理的更新方法。 對於  FileStore, 將 session 寫入到磁碟中。 對於 MemoryStore則無效果。
#