feat:新增文件、图片、云阶、版本信息特性

Author: tyza66

README.md

@@ -6,9 +6,11 @@
 ### 一、产品概述
 
 - PHP通用简单小工具，简称SSU
-- 时间戳、云变量
+- 时间戳、云变量、图片访问、文件下载、版本信息管理、迷你云阶
 - 可用于支持PHP的云主机、云服务器、云虚拟机
-- 云变量可用于发卡、懒后端、慢消息队列
+- 云变量可用于发卡、懒后端、慢消息队列、区块链
+- 支持密码访问图片、密码下载文件、版本信息动态更新
+- 迷你云阶支持负载均衡、动静态随机、无感更新、静态云变量
 - 任何操作均需携带密钥操作，安全防盗用
 - 参数错误或操作无效时进行无感返回
 - PHP项目可能存在漏洞，公益项目还请手下留情（不要攻击我，可以提漏洞）
@@ -29,11 +31,15 @@
 - 每个功能具有单独公钥，独立配置
 - 公钥修改位置在app/common.php
 
-### 三、数据库配置
+### 三、数据配置
 
 - 数据库应指定为您自己的数据库，项目中所带的无法直接使用
 - 数据库配置位于config/database.php
 - 若您使用了.env，请注意您的.env配置
+- 文件、图片、云阶、版本信息请修改runtime文件夹下对应文件
+- 请勿删除example文件，它们同时也是混淆使用的默认信息
+- 若需要拓展则需要按照example中提供的格式修改
+- 云阶、版本信息等xml信息功能传参无需携带文件后缀名，文件名就是name
 
 ### 四、时间戳接口
 
@@ -136,7 +142,163 @@
      1
      ```
 
-### 六、错误代码
+### 六、图片访问
+
+> /picture/get
+
+   - 接口说明：携带密码访问图片
+   - 请求方式：get
+- 请求参数
+     ```
+     注意! 所有参数必传
+     key: 图片功能公钥
+     name: 图片文件全名(带后缀名,目标文件在runtime/picture文件夹)
+     ```
+- 返回类型：file
+
+- 返回示例：
+     ```
+     直接显示图片
+     ```
+
+### 七、文件下载
+
+> /file/get
+
+   - 接口说明：携带密码下载文件
+   - 请求方式：get
+- 请求参数
+     ```
+     注意! 所有参数必传
+     key: 文件功能公钥
+     name: 文件全名称(带后缀名,目标文件在runtime/file文件夹)
+     ```
+- 返回类型：file
+
+- 返回示例：
+     ```
+     直接下载文件
+     ```
+
+### 八、版本信息管理
+
+> /version/all
+
+   - 接口说明：获取指定产品的版本信息
+   - 请求方式：get
+- 请求参数
+     ```
+     注意! 所有参数必传
+     key: 版本功能公钥
+     name: 要获得的版本信息(不带后缀名,信息存放在runtime/version文件夹)
+     ```
+- 返回类型：json
+
+- 返回示例：
+     ```
+     {
+         "versionInfo": {
+             "name": {
+                 "zh-cn": "简单小软件",
+                 "en": "SimpleSmallUtil"
+             },
+             "description": {
+                 "zh-cn": "PHP通用简单小工具",
+                 "en": "PHP universal simple gadget."
+             },
+             "icon": "https://s2.loli.net/2025/02/28/xMY7QVAfa4sIyrJ.jpg",
+             "lastest": "1.0.20250309",
+             "tags": {
+                 "tag": [
+                     "办公软件",
+                     "开发者工具"
+                 ]
+             },
+             "platforms": {
+                 "platform": "全平台"
+             },
+             "architectures": {
+                 "architecture": [
+                     "x86",
+                     "x64"
+                 ]
+             },
+             "extends": {},
+             "versions": {
+                 "version": [
+                     {
+                         "number": "1.0.20250228",
+                         "releaseDate": "2025-02-28",
+                         "features": {
+                             "feature": [
+                                 "初始版本发布",
+                                 "基本功能实现"
+                             ]
+                         },
+                         "Links": {
+                             "Link": [
+                                 "https://www.mutantcat.org/software/simplesmallutil",
+                                 "https://pan.baidu.com/share/init?surl=2DCvhlz5NhQpWiZS0Z3nBA&pwd=nu2w",
+                                 "https://shuntaoyuan.lanzout.com/ioCrb2p54hdc",
+                                 "https://github.com/Mutantcat-Working-Group/SimpleSmallUtil/releases/tag/v1.0.20250228"
+                             ]
+                         },
+                         "extends": {}
+                     },
+                     {
+                         "number": "1.0.20250309",
+                         "releaseDate": "2025-08-09",
+                         "features": {
+                             "feature": "新增图片、版本、文件、云阶"
+                         },
+                         "Links": {
+                             "Link": "https://www.mutantcat.org/software/simplesmallutil"
+                         },
+                         "extends": {}
+                     }
+                 ]
+             }
+         }
+     }
+     ```
+     
+> /version/lastest
+
+   - 接口说明：获取指定产品的最新版本号
+   - 请求方式：get
+- 请求参数
+     ```
+     注意! 所有参数必传
+     key: 版本功能公钥
+     name: 要获得的版本信息(不带后缀名,信息存放在runtime/version文件夹)
+     ```
+- 返回类型：string
+
+- 返回示例：
+     ```
+     1.0.20250309
+     ```
+
+### 九、迷你云阶
+
+> /cloudstep/get
+
+   - 接口说明：以云阶的方式获取数据
+   - 请求方式：get
+- 请求参数
+     ```
+     注意! 所有参数必传
+     key: 迷你云阶功能公钥
+     name: 要获得的版本信息(不带后缀名,信息存放在runtime/cloudstep文件夹)
+     ```
+- 返回类型：string
+
+- 返回示例：
+     ```
+     mutantcat
+     ```
+
+### 十、错误代码
 
 - `-2`: 事务执行失败
 

app/common.php

@@ -2,9 +2,38 @@
 // 应用公共文件
 
 // 配置公钥
+
+// 时间戳公钥
 if (!defined('TIME_PUBLIC_KEY')) {
-    define('TIME_PUBLIC_KEY', 'ttt-mutantcat-TTT');
+    define('TIME_PUBLIC_KEY', 'mutantcat');
 }
+
+// 云变量公钥
 if (!defined('VALUE_PUBLIC_KEY')) {
-    define('VALUE_PUBLIC_KEY', 'm8u8t8a8n8t8c8a8t');
+    define('VALUE_PUBLIC_KEY', 'mutantcat');
+}
+
+// 图片公钥
+if (!defined('PICTURE_PUBLIC_KEY')) {
+    define('PICTURE_PUBLIC_KEY', 'mutantcat');
+}
+
+// 文件公钥
+if (!defined('FILE_PUBLIC_KEY')) {
+    define('FILE_PUBLIC_KEY', 'mutantcat');
+}
+
+// 版本公钥
+if (!defined('VERSION_PUBLIC_KEY')) {
+    define('VERSION_PUBLIC_KEY', 'mutantcat');
+}
+
+// 文件公钥
+if (!defined('FILE_PUBLIC_KEY')) {
+    define('FILE_PUBLIC_KEY', 'mutantcat');
+}
+
+// 云阶公钥
+if (!defined('CLOUDSTEP_PUBLIC_KEY')) {
+    define('CLOUDSTEP_PUBLIC_KEY', 'mutantcat');
 }

app/controller/Index.php

@@ -8,7 +8,7 @@ class Index extends BaseController
 {
     public function index()
     {
-        return '用于简单小工具(SSU)的请求接口';
+        return 'Welcome,SimpleSmallUtil.xml(SSU),mutantcat.org';
     }
 
     public function ping(){

app/controller/cloudstep/CloudStep.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace app\controller\cloudstep;
+
+class CloudStep
+{
+    public function index()
+    {
+        return 'mutantcat.org';
+    }
+
+    public function getCloudStep()
+    {
+        $rootPath = dirname(__DIR__, 3); // 项目根路径
+        $public_key = input('get.key'); // 从GET请求中获取密钥
+        $filename = input('get.name'); // 从GET请求中获取文件名
+
+        if ($public_key != CLOUDSTEP_PUBLIC_KEY) {
+            $filePath = $rootPath . '/runtime/cloudstep/example_cloudstep.xml';
+        }else if (!$filename) {
+            $filePath = $rootPath . '/runtime/cloudstep/example_cloudstep.xml';
+        } else {
+            $filePath = $rootPath . '/runtime/cloudstep/' . $filename . '.xml';
+        }
+
+        // 验证文件是否存在且路径合法
+        if (!file_exists($filePath) || strpos(realpath($filePath), realpath($rootPath . '/runtime/cloudstep/')) !== 0) {
+            $filePath = $rootPath . '/runtime/cloudstep/example_cloudstep.xml';
+        }
+
+        // 读取并解析 XML 文件
+        try {
+            // 将 XML 文件加载为 PHP 对象
+            $xmlObject = simplexml_load_file($filePath);
+
+            switch ($xmlObject->mode){
+                case "random":
+                    // 先获得targets的数量
+                    $targetCount = count($xmlObject->targets->target);
+                    // 随机选择一个
+                    $randomIndex = rand(0, $targetCount - 1);
+                    return $xmlObject->targets->target[$randomIndex];
+                    break;
+                default:
+                    return "-1";
+            }
+        } catch (\Exception $e) {
+            // 处理解析错误
+            return "-1";
+        }
+    }
+}

app/controller/file/FileGetter.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace app\controller\file;
+
+class FileGetter
+{
+    public function index()
+    {
+        return 'mutantcat.org';
+    }
+
+    public function getFile()
+    {
+        $rootPath = dirname(__DIR__, 3); // 项目根路径
+        $public_key = input('get.key'); // 从GET请求中获取密钥
+        $filename = input('get.name'); // 从GET请求中获取文件名
+
+        // 验证密钥
+        if ($public_key != FILE_PUBLIC_KEY) {
+            $filePath = $rootPath . '/runtime/file/example_file.txt';
+        }else if (!$filename) {
+            $filePath = $rootPath . '/runtime/file/example_file.txt';
+        } else {
+            $filePath = $rootPath . '/runtime/file/' . $filename;
+        }
+        // 验证文件是否存在且路径合法
+        if (!file_exists($filePath) || strpos(realpath($filePath), realpath($rootPath . '/runtime/file/')) !== 0) {
+            $filePath = $rootPath . '/runtime/file/example_file.txt';
+        }
+
+        // 获取文件的 MIME 类型并设置响应头
+        $fileInfo = mime_content_type($filePath);
+        header("Content-Type: $fileInfo");
+
+        // 设置下载头，指定下载文件名
+        header("Content-Disposition: attachment; filename=" . basename($filePath));
+        header("Content-Length: " . filesize($filePath));
+
+        // 输出文件内容
+        readfile($filePath);
+
+        // 终止脚本执行
+        exit;
+    }
+}

app/controller/picture/PictureGetter.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace app\controller\picture;
+
+include dirname(__DIR__, 2) . '/common.php';
+
+
+class PictureGetter
+{
+    public function index()
+    {
+        return 'mutantcat.org';
+    }
+
+    public function getPicture()
+    {
+        $rootPath = dirname(__DIR__, 3);
+        $public_key = input('get.key');
+        $filename = input('get.name');
+
+        // 不可缺少 缺少返回example图片
+        if ($public_key != PICTURE_PUBLIC_KEY) {
+            $filePath = $rootPath . '/runtime/picture/example_picture.jpg';
+        } else if (!$filename) {
+            $filePath = $rootPath . '/runtime/picture/example_picture.jpg';
+        } else {
+            $filePath = $rootPath . '/runtime/picture/' . $filename;
+        }
+
+        // 验证文件是否存在且是否为安全路径
+        if (!file_exists($filePath) || strpos(realpath($filePath), realpath($rootPath . '/runtime/picture/')) !== 0) {
+            $filePath = $rootPath . '/runtime/picture/example_picture.jpg';
+        }
+
+        // 获取文件的 MIME 类型并设置响应头
+        $fileInfo = mime_content_type($filePath);
+        header("Content-Type: $fileInfo");
+
+        // 设置文件为可下载（可选）
+        // header("Content-Disposition: attachment; filename=" . basename($filePath));
+
+        // 输出文件内容
+        readfile($filePath);
+
+        // 终止脚本执行
+        exit;
+    }
+
+}