發布 1.0.0 版本。

Author: pardnchiu

.gitignore

@@ -0,0 +1,9 @@
+# 忽略 VSCode 的工作台設定檔案
+*.code-workspace
+
+# 忽略 macOS 系統自動生成的 .DS_Store 檔案與資料夾圖標
+.DS_Store
+Icon?
+
+# 忽略其他
+memo.md

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 邱敬幃 Pardn Chiu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,80 @@
+# PD\Session
+
+> PD\Session is a flexible PHP session manager with Redis support and filesystem fallback. Provides secure session handling with automated storage selection and built-in security features.
+
+![tag](https://img.shields.io/badge/tag-PHP%20Library-bb4444) 
+![size](https://img.shields.io/github/size/pardnchiu/PHP-Session/src/Session.php)<br>
+![version](https://img.shields.io/packagist/v/pardnchiu/session)
+![download](https://img.shields.io/packagist/dm/pardnchiu/session)
+
+## Features
+
+- Dual storage support (Redis/Filesystem)
+- Automatic fallback mechanism
+- Session security enhancements
+- Built-in session lifetime management
+- Session ID regeneration
+- Creation time tracking
+
+## Security Features
+
+- 7-day session lifetime
+- Automatic garbage collection
+- Session ID regeneration support
+- Secure storage handling
+- Fallback mechanism for system resilience
+
+## Dependencies
+
+- `pardnchiu/redis` - For Redis caching support (optional)
+- `/storage/sessions` - Write permission on storage directory 
+
+## How to Use
+
+### Install
+
+```SHELL
+composer require pardnchiu/session
+```
+
+```PHP
+// Initialize with Redis support
+$redis = new PD\Redis();
+$session = new PD\Session($redis);
+
+// Basic session operations
+$session->set('user_id', 123);
+$userId = $session->get('user_id');
+$session->delete('user_id');
+
+// Security operations
+$session->regenerateId();  // Regenerate session ID
+$session->destroy();       // Destroy session
+
+// Session information
+$sessionId = $session->getId();
+$createdTime = $session->getCreatedTime();
+
+// Initialize without Redis (filesystem only)
+$session = new PD\Session();
+```
+
+## License
+
+This source code project is licensed under the [MIT](https://github.com/pardnchiu/PHP-Session/blob/main/LICENSE) license.
+
+## Creator
+
+<img src="https://avatars.githubusercontent.com/u/25631760" align="left" width="96" height="96" style="margin-right: 0.5rem;">
+
+<h4 style="padding-top: 0">邱敬幃 Pardn Chiu</h4>
+
+<a href="mailto:[email protected]" target="_blank">
+    <img src="https://pardn.io/image/email.svg" width="48" height="48">
+</a> <a href="https://linkedin.com/in/pardnchiu" target="_blank">
+    <img src="https://pardn.io/image/linkedin.svg" width="48" height="48">
+</a>
+
+***
+
+©️ 2024 [邱敬幃 Pardn Chiu](https://pardn.io)

composer.json

@@ -0,0 +1,40 @@
+{
+    "name": "pardnchiu/session",
+    "description": "PD\\Session is a flexible PHP session manager with Redis support and filesystem fallback, providing secure session handling with automated storage selection.",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "邱敬幃 Pardn Chiu",
+            "email": "[email protected]"
+        }
+    ],
+    "minimum-stability": "stable",
+    "require": {
+        "php": ">=8.0"
+    },
+    "suggest": {
+        "pardnchiu/redis": "For Redis caching support"
+    },
+    "require-dev": {},
+    "autoload": {
+        "psr-4": {
+            "PD\\": "src/"
+        },
+        "exclude-from-classmap": [
+            ".gitignore",
+            "*.md",
+            "composer.json"
+        ]
+    },
+    "autoload-dev": {
+        "psr-4": {}
+    },
+    "scripts": {},
+    "extra": {
+        "branch-alias": {}
+    },
+    "config": {
+        "sort-packages": true
+    }
+}

src/Session.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace PD;
+
+class Session
+{
+    // 建構函式，根據 Redis 連線情況設定 Session 儲存方式
+    public function __construct($REDIS_CLIENT = null)
+    {
+        // 顯示所有錯誤，並設定 Session 時間與垃圾回收時間
+        ini_set("display_errors", 1);
+        ini_set("display_startup_errors", 1);
+        ini_set("session.cookie_lifetime", 86400 * 7);  // 7天有效
+        ini_set("session.gc_maxlifetime", 86400 * 7);   // 7天過期
+        error_reporting(E_ALL);
+
+        // 如果 Redis 連線可用，則使用 Redis 儲存 Session
+        if ($REDIS_CLIENT->isConnected()) {
+            $host = (string) $_ENV["REDIS_HOST"] ?? "localhost";
+            $port = (int) $_ENV["REDIS_PORT"] ?? 6379;
+            $password = (string) $_ENV["REDIS_PASSWORD"] ?? '';
+            $uri = "tcp://" . $host . ":" . $port . "?auth=" . $password . "&database=0&persistent=1"; // Redis 連線 URI
+
+            // 設定 Session 儲存方式為 Redis
+            ini_set("session.save_handler", "redis");
+            ini_set("session.save_path", $uri);
+        } else {
+            // 如果 Redis 不可用，使用本地檔案儲存 Session
+            $folder = $_SERVER["DOCUMENT_ROOT"] . "/storage/sessions";
+
+            // 若資料夾不存在且無法創建，則返回
+            if (!is_dir($folder) && !mkdir($folder, 0777, true)) {
+                return;
+            };
+
+            // 如果資料夾不可寫入，則返回
+            if (!is_writable($folder)) {
+                return;
+            };
+
+            // 設定 Session 儲存方式為檔案
+            ini_set("session.save_handler", "files");
+            ini_set("session.save_path", $folder);
+        };
+
+        // 開始 Session（若未啟動）
+        if (session_status() == PHP_SESSION_NONE) {
+            session_start();
+        };
+    }
+
+    // 設定 Session 值
+    public function set($key, $value)
+    {
+        $_SESSION[$key] = $value;
+    }
+
+    // 取得 Session 值
+    public function get($key)
+    {
+        return isset($_SESSION[$key]) ? $_SESSION[$key] : null;
+    }
+
+    // 刪除 Session 值
+    public function delete($key)
+    {
+        if (isset($_SESSION[$key])) {
+            unset($_SESSION[$key]);
+        };
+    }
+
+    // 銷毀整個 Session
+    public function destroy()
+    {
+        session_destroy();
+    }
+
+    // 重新生成 Session ID
+    public function regenerateId()
+    {
+        session_regenerate_id(true);
+    }
+
+    // 取得當前 Session 的 ID
+    public function getId()
+    {
+        return session_id();
+    }
+
+    // 取得 Session 創建時間
+    public function getCreatedTime()
+    {
+        if (!isset($_SESSION["created_time"])) {
+            $_SESSION["created_time"] = time();
+        };
+
+        return $_SESSION["created_time"];
+    }
+}