發布 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,70 @@
+# PD\Redis
+
+> A lightweight Redis client wrapper for PHP, providing simplified Redis operations with automatic connection management. Built on top of Predis.
+
+![tag](https://img.shields.io/badge/tag-PHP%20Library-bb4444) 
+![size](https://img.shields.io/github/size/pardnchiu/PHP-Redis/src/SQL.php)<br>
+![version](https://img.shields.io/packagist/v/pardnchiu/redis)
+![download](https://img.shields.io/packagist/dm/pardnchiu/redis)
+
+## Features
+
+- Automatic connection management
+- Environment-based configuration
+- Persistent connection support
+- Automatic database selection
+- Built-in error handling
+- Connection state monitoring
+- Automatic cleanup on destruction
+
+## Required Environment Variables
+
+```
+REDIS_HOST=localhost    # Required: Redis server host
+REDIS_PORT=6379         # Required: Redis server port
+REDIS_PASSWORD=secret   # Optional: Redis server password
+```
+
+## How to Use
+
+### Install
+
+```SHELL
+composer require pardnchiu/redis
+```
+
+```PHP
+// Initialize Redis client
+$redis = new PD\Redis();
+
+// Set value with expiration
+$redis->set(0, "user:123", "user_data", 3600); // db 0, expires in 1 hour
+
+// Get value
+$data = $redis->get(0, "user:123"); // from db 0
+
+// Check connection status
+if ($redis->isConnected()) {
+    // Redis is connected and ready
+}
+```
+
+## License
+
+This source code project is licensed under the [MIT](https://github.com/pardnchiu/PHP-Redis/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,38 @@
+{
+    "name": "pardnchiu/redis",
+    "description": " A lightweight Redis client wrapper for PHP, providing simplified Redis operations with automatic connection management. Built on top of Predis.",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "邱敬幃 Pardn Chiu",
+            "email": "[email protected]"
+        }
+    ],
+    "minimum-stability": "stable",
+    "require": {
+        "php": ">=8.0",
+        "predis/predis": "^2.0"
+    },
+    "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/Redis.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace PD;
+
+class Redis
+{
+    private $client;
+
+    // 建構函式，初始化 Redis 連線
+    public function __construct()
+    {
+        $this->getConnection(); // 確保連線初始化
+    }
+
+    // 檢查 Redis 是否已連線
+    public function isConnected()
+    {
+        return $this->client !== null;
+    }
+
+    // 連接 Redis 伺服器
+    private function getConnection()
+    {
+        // 如果已經連線，則不再進行連線
+        if ($this->client !== null) {
+            return;
+        };
+
+        try {
+            // 從環境變數中讀取 Redis 配置，若無則使用預設值
+            $host = (string) $_ENV["REDIS_HOST"] ?? "localhost";
+            $port = (int) $_ENV["REDIS_PORT"] ?? 6379;
+            $password = (string) $_ENV["REDIS_PASSWORD"] ?? '';
+            $options  = [
+                "host" => $host,
+                "port" => $port,
+                "persistent" => true
+            ];
+
+            // 如果有密碼則添加至選項中
+            if (!empty($password)) {
+                $options["password"] = $password;
+            };
+
+            // 使用 Predis 來建立 Redis 連線
+            $this->client = new \Predis\Client($options);
+            $this->client->select(0); // 選擇資料庫 0
+            $this->client->connect(); // 建立連線
+        } catch (\Exception $err) {
+            // 若無法連線，輸出錯誤並設為 null
+            PrintError("Redis 無法連線: " . $err->getMessage());
+            http_response_code(500);
+            $this->client = null;
+        };
+    }
+
+    // 從 Redis 中取得資料
+    public function get($db, $key)
+    {
+        $this->getConnection(); // 確保連線有效
+
+        // 若 Redis 已連線，則從指定的資料庫取得指定鍵值的資料
+        if ($this->client !== null) {
+            $this->client->select($db);
+            $result = $this->client->get($key);
+            return $result;
+        };
+
+        return null;
+    }
+
+    // 設定資料到 Redis 中
+    public function set($db, $key, $content, $expire)
+    {
+        $this->getConnection(); // 確保連線有效
+
+        // 若 Redis 已連線，則將資料寫入指定的資料庫，並設置過期時間
+        if ($this->client !== null) {
+            $this->client->select($db);
+            $this->client->set($key, $content);
+            $this->client->expire($key, $expire);
+        };
+    }
+
+    // 在物件銷毀時，斷開 Redis 連線
+    public function __destruct()
+    {
+        if ($this->client !== null && $this->client->ping()) {
+            $this->client->disconnect(); // 斷開連線
+            $this->client = null;
+        };
+    }
+}