Session 完整教程（二）：PHP3 時代 PHPlib Session 庫安裝與使用詳解

PHP3 下實現 Session 的標準方案：PHPlib

PHP 3 缺乏原生 Session，PHPlib 成為事實標準，提供用戶認證、會話管理、權限控制、數據庫抽象等功能。

安裝步驟 (Win2000 + Apache 1.3.12 + PHP 3.0.16 + PHPlib 7.2c)

1. 解壓 PHPlib，將 php 目錄複製到 Apache 安裝目錄（如 d:/apache/php）。
2. 將 pages 目錄下文件複製到 htdocs 根目錄。
3. 修改 d:/apache/php/prepend.php3：

if (!isset($_PHPLIB) || !is_array($_PHPLIB)) {
    $_PHPLIB["libdir"] = "d:/apache/php/"; // PHPlib 目錄
}

4. 修改 d:/apache/php/local.inc 配置數據庫連接：

class DB_Example extends DB_Sql {
    var $Host = "localhost";
    var $Database = "test";
    var $User = "root";
    var $Password = "";
}

5. 執行 stuff/create_database.mysql 初始化數據表。
6. 在 php3.ini 設置 auto_prepend_file = "d:/apache/php/prepend.php3"，並將 PHPlib 目錄加入 include_path。

頁面級使用規範

<?php
page_open(array("sess" => "Example_session")); // 必須在任何輸出前調用
// 業務邏輯
$sess->register("var_name"); // 註冊會話變量
// ...
page_close(); // 腳本結束前調用，將變量寫回數據庫
?>

關鍵操作

• 註冊變量：$sess->register("var_name")（不帶 $ 符號）。
• 讀取/修改：直接使用 $var_name，修改自動生效。
• 刪除變量：$sess->unregister("var_name")。
• 存儲後端：支持 MySQL、PostgreSQL、Oracle、共享內存、LDAP 等。

注意：page_open 前不可有任何輸出（含空行），否則報 SetCookie called after header 錯誤。