# php-tools

**Repository Path**: yimu321/php-tools

## Basic Information

- **Project Name**: php-tools
- **Description**: 🧩 多工具集成在同一目录下，统一 UI 风格；
🧵 无第三方库依赖，拖进支持 PHP 的 Web 目录即可跑；
🧪 适合本地调试、小工具聚合、快速测试用；
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PHP 小工具合集 🔧

> 项目不依赖任何第三方库，放到支持 PHP 的 Web 目录即可使用。

**轻量 · 无依赖 · 自用小工具集合**

- 🧩 多工具集成在同一目录下，统一 UI 风格
- 🧵 无第三方库依赖，拖进支持 PHP 的 Web 目录即可跑
- 🧪 适合本地调试、小工具聚合、快速测试用

---

这是一个基于 PHP 的轻量级小工具集合，目前包含：

- 📁 网站根目录文件管理工具（index.php）
- 🎯 Banner 序列化生成工具（php-serialize.php）
- 📄 Markdown 查看工具（markdown-viewer.php）
- 🧾 JSON 查看工具（json-viewer.php）
- 🧪 正则测试工具（regex-tester.php）
- 🔐 编解码工具（codec-tool.php）
- ⏱ 时间戳 / 日期转换工具（time-tool.php）
- ⚙️ PHP 配置信息面板（php-config.php）
- 🌐 HTTP 请求调试工具（http-tester.php）
- 🔒 哈希计算工具（hash-tool.php）
- 🔤 字符串处理工具（string-tool.php）
- 🔑 密码生成器（password-generator.php）
- 🆔 UUID 生成器（uuid-tool.php）
- 📏 文件大小转换工具（file-size-tool.php）
- 🖼️ Base64 图片编码/解码工具（image-base64-tool.php）
- 🎨 颜色转换工具（color-tool.php）
- 🌐 IP 地址工具（ip-tool.php）
- 📷 图片查看工具（image-viewer.php）
- 📊 系统信息面板（panel.php）
- 🌐 网络工具（network-tool.php）

所有工具都使用统一的简洁 UI 风格，并在页面中使用本地 `image/php-logo.svg` 作为 favicon。

---

## 运行环境 ⚙️

- PHP 版本：建议 7.4+（兼容 8.x）
- Web 服务器：Apache、Nginx 或内置 PHP 服务器均可
- 部署路径：本仓库内容放置于 Web 根目录或子目录

---

## 功能一览 🚀

- 🔍 扫描站点根目录下所有文件 / 目录，支持自定义显示名称与黑名单
- 🧮 快速生成 Banner 的 PHP `serialize` 字符串并预览反序列化结果
- 📝 在线渲染 Markdown 文件，支持标题、列表、代码块、图片、引用块等
- 🎨 统一的卡片式 UI，适配常见桌面与移动端宽度

---

## 工具详情 🧩

### 1. 网站根目录文件管理工具（index.php）🗂️ 
主要功能： 
- 📂 扫描站点根目录下所有文件和文件夹
- ✏️ 支持为任意文件 / 目录设置自定义显示名称（存储在 Session 中） 
- 🚫 支持将指定文件 / 目录加入黑名单，在列表中隐藏 
- 📥 支持批量选择文件 / 目录并一次性加入黑名单（前端一次性提交，后端批量处理） 
- 📑 智能跳转：
  - `.md` / `.markdown` 文件 → Markdown 查看工具
  - 图片文件 → 图片查看工具
- 🔍 实时搜索功能，支持按名称过滤文件列表
- 📊 点击量统计：记录每个文件的访问次数
- 🔢 多种排序方式：
  - 名称排序（升序/降序）
  - 创建时间排序（升序/降序）
  - 文件大小排序（升序/降序）
  - 点击量排序（升序/降序）
- 📁 树形目录结构：支持目录展开/折叠，默认折叠状态
- 🏷️ 文件分类功能：
  - 工具类（以"工具-"开头）
  - 预览类（以"预览-"开头）
  - 面板类（以"面板"开头）
  - 其他类（无特殊前缀）
- 📊 系统面板入口：快速访问系统信息和统计数据
访问方式：
- 📁 将 `index.php` 放置在网站根目录（或虚拟主机根目录）
- 🌐 通过浏览器访问对应 URL，例如：  
> `http://your-domain.com/index.php` 
> 或 `http://your-domain.com/php-tools/index.php` 

### 2. Banner 序列化生成工具（php-serialize.php）🔄
主要功能： 
- 📝 在代码中以数组形式维护 Banner 配置 
- 🔄 通过 PHP 内置 `serialize` 函数生成合法的序列化字符串 
- 📊 页面中展示生成结果及反序列化后的数据结构，方便对比检查 
访问方式：
- 📁 将 `php-serialize.php` 放置在可访问目录 
- 🌐 通过浏览器访问：
> `http://your-domain.com/php-serialize.php`

> 要修改 Banner 内容，只需要编辑 `php-serialize.php` 中的 `$bannerData` 数组。

### 3. Markdown 查看工具（markdown-viewer.php）🔍
主要功能： 
- 🔗 通过 `path` 参数指定要打开的 Markdown 文件路径 
- 🔄 支持以站点根目录为基准的路径（可带 `/`，也可不带） 
- 📝 渲染常见 Markdown 语法： 
  > 标题（`#`~`######`） 
  > 无序列表（`-` / `*`） 
  > 行内代码与代码块（``` 包裹） 
  > 图片（支持相对路径与绝对路径） 
  > 链接 
  > 引用块（以 `>` 开头的内容） 

示例： 
- 打开站点根目录下的 `README.md`：
   `http://your-domain.com/markdown-viewer.php?path=/README.md`
- 在使用本地自定义域名时：
   `http://php.tools.yimu/markdown-viewer.php?path=/README.md`

> 对 `.md` / `.markdown` 文件，从 `index.php` 列表点击时会自动跳转到 `markdown-viewer.php` 进行渲染展示。

### 4. JSON 查看工具（json-viewer.php）📊

主要功能：
- 📚对输入的 JSON 文本进行语法检查与格式化（缩进、美化）
- 📝将合法 JSON 转换为 PHP 数组形式，方便复制到代码中
- 🧪提供一键填充示例数据，快速体验格式化效果

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/json-viewer.php`
- 将原始 JSON 粘贴到输入框中：
  - 点击「格式化 JSON」按钮，查看美化后的 JSON
  - 点击「JSON 转 PHP 数组」按钮，查看对应的 PHP 数组代码

### 5. 正则测试工具（regex-tester.php）🧪

主要功能：
- 输入正则表达式与待匹配文本，运行 `preg_match_all`
- 支持常用修饰符：`i`、`m`、`s`、`u`、`x`、`A`、`D` 等
- 展示匹配次数与每次匹配的捕获分组结果
- 如果表达式不合法或 PCRE 发生错误，会给出友好错误信息

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/regex-tester.php`
- 输入表达式与文本，可点击「填充示例」快速体验

### 6. 编解码工具（codec-tool.php）🔐

主要功能：
- 对文本进行 Base64 编码 / 解码
- 对文本进行 URL 编码 / 解码
- 提供一键填充示例，方便快速验证结果

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/codec-tool.php`
- 在输入框中粘贴原始文本或已编码文本，点击对应按钮查看结果

### 7. 时间戳 / 日期转换工具（time-tool.php）⏱

主要功能：
- 在 Unix 时间戳与日期时间字符串之间相互转换
- 支持指定时区（如 `Asia/Shanghai`），不指定则使用当前默认时区
- 提供一键填充当前时间戳和当前日期时间

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/time-tool.php`
- 在「时间戳 ➝ 日期时间」或「日期时间 ➝ 时间戳」区域中输入内容并转换

### 8. PHP 配置信息面板（php-config.php）⚙️

主要功能：
- 展示当前 PHP 版本与 SAPI
- 展示常用 ini 配置项（如 memory_limit、upload_max_filesize、post_max_size 等）
- 展示已加载扩展列表，便于确认环境依赖

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/php-config.php`
- 该面板只展示通用配置，不输出敏感信息或完整 phpinfo 内容

### 9. HTTP 请求调试工具（http-tester.php）🌐

主要功能：
- 发送简单的 HTTP 请求，支持 GET / POST / PUT / DELETE
- 支持自定义请求头和请求体，方便调试接口
- 显示请求概要、响应状态码、响应头和响应体
- 若启用了 curl 扩展，会优先使用 curl 进行请求

使用方式（建议仅在本地或受信环境使用）：
- 直接在浏览器中访问：
  > `http://your-domain.com/http-tester.php`
- 输入 URL、选择方法、补充请求头与请求体后发送请求，可使用「填充示例」按钮快速体验

### 10. 哈希计算工具（hash-tool.php）🔒

主要功能：
- 支持多种哈希算法（MD5、SHA1、SHA256、SHA512 等）
- 实时计算输入文本的哈希值
- 支持复制哈希结果到剪贴板
- 提供常用哈希算法的示例

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/hash-tool.php`
- 输入待计算的文本，选择算法，查看计算结果

### 11. 字符串处理工具（string-tool.php）🔤

主要功能：
- 字符串大小写转换
- 字符串截取、去除空白
- 字符串统计（长度、字符数、单词数）
- 字符串替换和正则替换

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/string-tool.php`
- 输入待处理的字符串，选择处理方式，查看结果

### 12. 密码生成器（password-generator.php）🔑

主要功能：
- 生成高强度随机密码
- 支持自定义密码长度
- 支持包含/排除数字、大小写字母、特殊字符
- 支持生成多个密码

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/password-generator.php`
- 设置密码参数，点击生成按钮，复制生成的密码

### 13. UUID 生成器（uuid-tool.php）🆔

主要功能：
- 生成符合 RFC 4122 标准的 UUID v4
- 支持批量生成多个 UUID
- 支持复制单个或所有 UUID

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/uuid-tool.php`
- 点击生成按钮，复制所需的 UUID

### 14. 文件大小转换工具（file-size-tool.php）📏

主要功能：
- 在不同文件大小单位之间转换（B、KB、MB、GB、TB）
- 支持自动识别输入单位
- 显示多种单位的转换结果

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/file-size-tool.php`
- 输入文件大小，选择输入单位，查看转换结果

### 15. Base64 图片编码/解码工具（image-base64-tool.php）🖼️

主要功能：
- 将图片文件转换为 Base64 编码
- 将 Base64 编码转换为图片
- 支持多种图片格式
- 支持复制 Base64 编码

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/image-base64-tool.php`
- 选择图片文件或输入 Base64 编码，查看转换结果

### 16. 颜色转换工具（color-tool.php）🎨

主要功能：
- 在 HEX、RGB、HSL 颜色格式之间转换
- 实时预览颜色效果
- 支持复制颜色代码

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/color-tool.php`
- 输入颜色代码，查看转换结果和预览

### 17. IP 地址工具（ip-tool.php）🌐

主要功能：
- IP 地址验证
- IP 地址转换（IPv4 <-> 整数）
- 子网掩码计算
- 网络地址和广播地址计算

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/ip-tool.php`
- 输入 IP 地址和子网掩码，查看计算结果

### 18. 图片查看工具（image-viewer.php）📷

主要功能：
- 查看各种图片格式（PNG、JPG、JPEG、GIF、BMP、SVG、WebP、ICO）
- 显示图片详细信息（尺寸、格式、大小）
- 支持从文件管理工具直接跳转

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/image-viewer.php?path=/image/php-logo.svg`
- 或从文件管理工具中点击图片文件

### 19. 系统信息面板（panel.php）📊

主要功能：
- 显示系统信息（服务器软件、PHP 版本、操作系统等）
- 显示 PHP 配置信息（内存限制、执行时间、上传大小等）
- 显示项目统计数据（文件数、目录数、各类型文件数量等）
- 显示访问统计（总点击量、点击量排行等）

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/panel.php`
- 或从文件管理工具顶部导航栏点击「系统面板」按钮

### 20. 网络工具（network-tool.php）🌐

主要功能：
- Ping 测试：测试目标主机或 IP 地址的连通性
- Curl 测试：发送 HTTP 请求，支持多种请求方法（GET、POST、PUT、DELETE 等）
- 自定义请求头和请求体
- 显示完整的响应信息（状态码、响应头、响应体）
- 支持自动处理重定向

使用方式：
- 直接在浏览器中访问：
  > `http://your-domain.com/network-tool.php`
- 在 Ping 测试中输入目标主机或 IP 地址
- 在 Curl 测试中输入 URL、选择请求方法、添加请求头和请求体
- 点击执行按钮查看测试结果

---
## 配置说明 🛠

### .env 中的 BASE_URL

项目根目录下可以放置一个简单的 `.env` 文件，例如：

```env
BASE_URL=http://php.tools.yimu
```

用途：

- 在 Markdown 渲染时，将站点内的绝对路径（以 `/` 开头）转换为完整 URL，保证图片和链接在浏览器中可以正确访问
- 避免出现诸如 `http://php.tools.yimu/D:/...` 这类错误的本地磁盘路径

### PHP Logo 与 favicon

- 本地 PHP Logo 路径：`image/php-logo.svg`
- 所有页面统一通过 `<link rel="icon" type="image/svg+xml" href="image/php-logo.svg">` 使用该图标

> PHP 官方 Logo 源自 [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:PHP-logo.svg)，授权协议为 CC BY-SA 4.0。

---

## 相关代码位置 📂

- 扫描与界面逻辑：[`index.php`](file:///d:/phpstudy_pro/WWW/php-tools/index.php)
- 序列化工具逻辑：[`php-serialize.php`](file:///d:/phpstudy_pro/WWW/php-tools/php-serialize.php)
- Markdown 渲染与路径处理：[`markdown-viewer.php`](file:///d:/phpstudy_pro/WWW/php-tools/markdown-viewer.php)
- JSON 查看工具：[`json-viewer.php`](file:///d:/phpstudy_pro/WWW/php-tools/json-viewer.php)
- 正则测试工具：[`regex-tester.php`](file:///d:/phpstudy_pro/WWW/php-tools/regex-tester.php)
- 编解码工具：[`codec-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/codec-tool.php)
- 时间戳 / 日期转换工具：[`time-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/time-tool.php)
- PHP 配置信息面板：[`php-config.php`](file:///d:/phpstudy_pro/WWW/php-tools/php-config.php)
- HTTP 请求调试工具：[`http-tester.php`](file:///d:/phpstudy_pro/WWW/php-tools/http-tester.php)
- 哈希计算工具：[`hash-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/hash-tool.php)
- 字符串处理工具：[`string-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/string-tool.php)
- 密码生成器：[`password-generator.php`](file:///d:/phpstudy_pro/WWW/php-tools/password-generator.php)
- UUID 生成器：[`uuid-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/uuid-tool.php)
- 文件大小转换工具：[`file-size-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/file-size-tool.php)
- Base64 图片编码/解码工具：[`image-base64-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/image-base64-tool.php)
- 颜色转换工具：[`color-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/color-tool.php)
- IP 地址工具：[`ip-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/ip-tool.php)
- 图片查看工具：[`image-viewer.php`](file:///d:/phpstudy_pro/WWW/php-tools/image-viewer.php)
- 系统信息面板：[`panel.php`](file:///d:/phpstudy_pro/WWW/php-tools/panel.php)
- 网络工具：[`network-tool.php`](file:///d:/phpstudy_pro/WWW/php-tools/network-tool.php)

---

## 开发与二次扩展建议 💡

- 如需持久化自定义名称和黑名单，可将 Session 存储改为数据库或文件
- 如需限制扫描范围，可将 `index.php` 顶部的 `$scanDir` 修改为指定目录路径
- 可以在前端增加搜索、筛选等能力，提升复杂目录下的可用性
- 为 Markdown 渲染增加有序列表、表格等更完整语法支持
- 将当前 UI 抽成组件样式，方便以后新增更多小工具时复用