Ruby CGI Session

Ruby CGI Session

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則無效果。