發布 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,76 @@
+# PD\Cache
+
+> PD\Cache is a hybrid caching system for PHP that combines Redis and filesystem caching with automatic fallback support. Provides seamless caching capabilities even when Redis is unavailable.
+
+![tag](https://img.shields.io/badge/tag-PHP%20Library-bb4444) 
+![size](https://img.shields.io/github/size/pardnchiu/PHP-Cache/src/SQL.php)<br>
+![version](https://img.shields.io/packagist/v/pardnchiu/cache)
+![download](https://img.shields.io/packagist/dm/pardnchiu/cache)
+
+## Features
+
+- Hybrid caching strategy (Redis + Filesystem)
+- Automatic fallback to filesystem when Redis is unavailable
+- Built-in content optimization for HTML/Text content
+- Automatic cache expiration handling
+- Cache cleanup mechanism
+- MD5 key generation for cache entries
+
+## Key Capabilities
+
+- Get/Set cache with automatic storage selection
+- Content minification for HTML/Text
+- Automatic cache expiration
+- Cache cleanup for expired entries
+- Fallback mechanism for system resilience
+
+## Dependencies
+
+- `pardnchiu/redis` - For Redis caching support (optional)
+- `/storage/caches` - Write permission on storage directory 
+
+## How to Use
+
+### Install
+
+```SHELL
+composer require pardnchiu/cache
+```
+
+```PHP
+// Initialize cache with Redis support
+$redis = new PD\Redis();
+$cache = new PD\Cache($redis);
+
+// Set cache with 1-hour expiration
+$cache->set("page-key", $content, 3600);
+
+// Get cached content
+$content = $cache->get("page-key");
+
+// Clean expired cache entries
+$cache->clean();
+
+// Initialize cache without Redis (filesystem only)
+$cache = new PD\Cache();
+```
+
+## License
+
+This source code project is licensed under the [MIT](https://github.com/pardnchiu/PHP-Cache/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:dev@pardn.io" 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/cache",
+    "description": "PD\\Cache is A hybrid caching system for PHP that combines Redis and filesystem caching with automatic fallback support.",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "邱敬幃 Pardn Chiu",
+            "email": "dev@pardn.io"
+        }
+    ],
+    "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/Cache.php

@@ -0,0 +1,119 @@
+<?php
+
+namespace PD;
+
+class Cache
+{
+    private $REDIS_CLIENT;
+
+    // 建構函式，初始化 Redis 客戶端
+    public function __construct($REDIS_CLIENT = null)
+    {
+        $this->REDIS_CLIENT = $REDIS_CLIENT;
+    }
+
+    // 取得快取資料
+    public function get($page)
+    {
+        $page_key = md5($page); // 生成頁面鍵值
+
+        // 若 Redis 已連線，從 Redis 取得資料
+        if ($this->REDIS_CLIENT->isConnected()) {
+            return $this->REDIS_CLIENT->get(1, $page_key);
+        };
+
+        // 設定快取檔案路徑
+        $folder = get_path("/storage/caches");
+        $file   = $folder . "/" . $page_key . ".json";
+
+        // 資料夾不存在且無法創建時，返回 null
+        if (!file_exists($folder) && !mkdir($folder, 0777, true)) {
+            return null;
+        };
+
+        // 資料夾不可寫入時，返回 null
+        if (!is_writable($folder)) {
+            return null;
+        };
+
+        // 快取檔案不存在時，返回 null
+        if (!file_exists($file)) {
+            return null;
+        };
+
+        $content = file_get_contents($file);    // 讀取快取檔案內容
+        $data    = json_decode($content, true); // 解碼 JSON 快取內容
+
+        // 快取過期，刪除並返回 null
+        if (isset($data["expire"]) && $data["expire"] < time()) {
+            unlink($file);
+            return null;
+        };
+
+        return $data["content"]; // 返回快取內容
+    }
+
+    // 設定快取資料
+    public function set($page, $content, $expire)
+    {
+        $page_key = md5($page);                              // 生成頁面鍵值
+        $content = preg_replace("/\n[ ]*/", "", $content);   // 移除多餘空白與換行
+        $content = preg_replace("/>[ ]*</", "><", $content); // 移除標籤間空白
+
+        // 若 Redis 已連線，將資料存入 Redis
+        if ($this->REDIS_CLIENT->isConnected()) {
+            $this->REDIS_CLIENT->set(1, $page_key, $content, $expire);
+            return $content;
+        };
+
+        // 設定快取檔案路徑
+        $folder = get_path("/storage/caches");
+        $file = $folder . "/" . $page_key . ".json";
+        $data = [
+            "content" => $content,
+            "expire" => time() + $expire
+        ]; // 設定快取資料
+
+        // 資料夾不存在且無法創建時，返回 null
+        if (!file_exists($folder) && !mkdir($folder, 0777, true)) {
+            return null;
+        }
+
+        // 資料夾不可寫入時，返回 null
+        if (!is_writable($folder)) {
+            return null;
+        };
+
+        // 將快取資料寫入檔案
+        file_put_contents($file, json_encode($data, JSON_HEX_APOS | JSON_HEX_QUOT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
+
+        return $content; // 返回快取內容
+    }
+
+    // 清理過期的快取資料
+    public function clean()
+    {
+        $folder = get_path("/storage/caches");
+
+        // 若資料夾不存在，直接返回
+        if (!file_exists($folder)) {
+            return;
+        };
+
+        $files = glob($folder . "/*.json"); // 獲取所有快取檔案
+
+        foreach ($files as $file) {
+            if (!file_exists($file)) {
+                continue;
+            };
+
+            $content = file_get_contents($file);    // 讀取快取檔案內容
+            $data    = json_decode($content, true); // 解碼 JSON 快取內容
+
+            // 若快取已過期，刪除快取檔案
+            if (isset($data["expire"]) && $data["expire"] < time()) {
+                unlink($file);
+            };
+        };
+    }
+}