# Ruby CGI Sessions 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 文件的前綴。 ### 實例化方法 | 方法 | 描述 | | --- | --- | | **[ ]** | 返回給定 key 的值。查看實例。 | | **[ ]=** | 設置給定 key 的值。 查看實例。 | | **delete** | 調用底層數據庫管理的刪除方法。對于 FileStore, 刪除包含 session 的物理文件。 對于 MemoryStore, 從內存中移除 session 數據。 | | **update** | 調用底層數據庫管理的更新方法。 對于 FileStore, 將 session 寫入到磁盤中。 對于 MemoryStore則無效果。 |