【核心功能架构】
本套工具箱源码采用PHP+JSON混合架构开发，通过模块化设计实现功能快速扩展。系统包含前端展示引擎与后台配置体系两大部分，所有工具数据存储在data/tool.json配置文件中，支持无限级分类管理与工具动态加载。

===文件结构解析===

1. 核心配置文件

• 网站信息配置：include/front/header.php

• 工具数据库：data/tool.json

• 样式控制库：assets/css/main.css

• 路由解析器：index.php

2. 工具存放规范

• 分类目录：tool/[分类名]/

• 工具文件：tool/[分类名]/[工具名]/index.php

• 资源目录：tool/[分类名]/[工具名]/assets/

• 必须与tool.json中的"category"和"name"字段完全匹配

【技术实现特性】
• 动态路由机制：自动解析URL加载对应工具
• JSON热加载：修改配置文件即时生效
• 权限控制系统：目录访问限制
• 跨工具通信：通过$_SESSION共享数据
• 缓存策略：工具页面静态化缓存

【配置修改指南】

1. 网站基础配置
   编辑include/front/header.php修改：

• 网站标题（<title>标签）

• 导航栏LOGO（navbar-brand部分）

• 统计代码（页面底部区域）

• 全局CSS样式表链接

2. 工具添加流程
   ① 在data/tool.json中添加新条目

json

复制

{  
    "category": "新分类",  
    "name": "新工具",  
    "desc": "功能描述",  
    "icon": "fa-icon"  }

② 创建工具目录：tool/新分类/新工具/
③ 编写功能文件：index.php + assets资源

3. 分类管理技巧

• 支持多级分类（父分类/子分类）

• 分类排序通过JSON数组顺序控制

• 分类图标采用Font Awesome 5库

【扩展开发建议】

1. 工具开发规范

• 必须包含meta.php定义工具参数

• 表单提交需使用POST方法

• 结果输出需包含在<tool-result>容器

• 复杂计算应启用AJAX异步请求

2. 安全防护建议

• 用户输入必须过滤htmlspecialchars()

• 文件上传需设置白名单

• 敏感操作需验证CSRF Token

• 错误信息禁止直接输出

【部署适配方案】

1. 环境要求

• PHP 5.6+（需开启JSON扩展）

• 文件权限设置（data/目录可写）

• 伪静态配置（Apache需.htaccess）

2. 访问路径示例

• 主站：https://domain.com

• 工具页：https://domain.com/分类名/工具名

• API接口：https://domain.com/api/tool/分类名/工具名

3. 性能优化建议

• 启用OPcache加速PHP

• 配置浏览器静态资源缓存

• 定期清理tmp/目录

• 使用CDN分发assets资源