注意：这是一款通过AI完成的网址导航程序，不是作者自己动手编写开发的，作者也只是提供开发思路。

网址导航系统（xmurl）

一个基于原生 PHP 开发的轻量级网址导航站。
零第三方依赖 —— 不引入任何 Composer 包、不用任何第三方 CSS/JS 框架，全部代码自行实现；同时支持 MySQL / SQLite 双数据库驱动，下载即用。

前台提供分类导航、多引擎搜索、热门排行、站点详情与搜索引擎权重查询；后台提供分类 / 网址 / 公告 / 系统设置的完整管理，以及投稿审核、数据导入导出、模板切换等运营能力。

• 当前版本：1.0.6（bootstrap.php 中的 XM_VERSION）
• 运行环境：PHP 7.4+（推荐 8.x）、MySQL 5.7+ / SQLite 3
• 授权：私有项目

一、核心特性

二、技术栈与设计约束

项目约定：

• 代码标识符（类 / 方法 / 变量 / 数组键）统一使用英文并遵循 PSR-12；注释、异常消息使用中文。
• 视图模板位于 views/**，由 Skin::resolve() 按区域（frontend / admin）解析。
• 前端资源通过 ?v=XM_VERSION 破缓存，修改 assets/ 下任意 css/js 后必须手动递增 XM_VERSION。
• 所有 <img> 必须声明 loading="lazy" decoding="async"；图片容器需有固定尺寸或 aspect-ratio，避免布局跳动。

三、目录结构

t.cc/
├── index.php            前台首页 / 公告列表 / 分类页（按 p / c / s / e / page 参数分流）
├── submit.php           前台投稿表单
├── detail.php           站点详情页（含权重查询面板）
├── go.php               出站跳转（点击计数 + 白名单校验）
├── fetchmeta.php        公开接口：抓取目标站标题/描述/图标
├── upload.php           公开接口：图标上传
├── weight.php           公开接口：搜索引擎权重查询
├── install.php          安装向导（首次部署用）
├── bootstrap.php        引导文件：常量、自动加载、配置、会话、数据库初始化
├── config.php           站点配置（数据库、调试、时区、站点 key）
│
├── core/                基础层
│   ├── Db.php           PDO 封装（查询构造、事务、表名引用）
│   ├── Auth.php         管理员认证（bcrypt 哈希、会话、口令修改）
│   ├── Csrf.php         CSRF 令牌生成与校验
│   ├── RateLimiter.php  IP 维度服务端限流（落盘 + 原子写 + 故障放行）
│   ├── Skin.php         模板解析与皮肤管理
│   └── Util.php         工具集（转义、输入、URL、图标、分页、IP 等）
│
├── app/model/           模型层
│   ├── Base.php         模型基类（增删改查、分页、排序、条件构造）
│   ├── Link.php         网址（前台查询、投稿、审核、点击、搜索）
│   ├── Category.php     分类（含合并、级联删除）
│   ├── Notice.php       公告
│   ├── Setting.php      系统设置（KV 表 + 分组 + 类型 + 默认值）
│   ├── Schema.php       建表 / 种子数据 / 幂等升级
│   ├── SiteMeta.php     外站信息抓取（SSRF 防护、HTML 解析）
│   ├── WeightQuery.php  搜索权重查询（三数据源 + 自定义适配 + 缓存）
│   ├── BacklinkChecker.php 友链回链自动检测
│   ├── IconUploader.php 图标上传校验与落盘
│   ├── Importer.php     数据导入（CSV / JSON）
│   └── Exporter.php     数据导出
│
├── admin/               后台
│   ├── index.php        后台页面路由（dashboard/categories/links/reviews/notices/settings/...）
│   └── api.php          后台统一 AJAX 接口（POST + 登录态 + CSRF）
│
├── views/               视图模板
│   ├── layout/          前台公共头尾（header / footer）
│   ├── admin/           后台各页面模板 + layout
│   ├── home.php         首页
│   └── notices.php      公告列表
│
├── assets/              前端资源
│   ├── style.css        前台样式（CSS 变量 + 深色模式）
│   ├── app.js           前台公共脚本
│   ├── submit.js        投稿页脚本（抓取、图标选择、校验）
│   ├── detail.js        详情页脚本（权重查询）
│   ├── admin.css        后台样式（含弹窗、响应式）
│   ├── admin.js         后台脚本（弹窗、表单、接口调用）
│   └── lazyload.js      图片懒加载兜底（老浏览器）
│
├── data/                运行时数据（缓存、证书、导出临时文件）
│   ├── cacert.pem       CA 根证书包（HTTPS 校验用）
│   ├── meta_*.dat       抓取结果缓存
│   ├── weight_*.dat     权重查询缓存
│   └── rate_*.dat       限流计数
│
└── uploads/             上传文件（图标等，需可外链访问）
    └── icons/YYYYmm/    按月归档的图标

四、数据模型

系统共 5 张表，全部通过 Schema::create() 建立，Schema::upgrade() 在每次请求时幂等补齐增量字段（老库可平滑升级，无需手工改表）。

settings 为键值表，扩展设置项不需要改表结构 —— 在 Setting::DEFAULTS 追加一行并在 Setting::GROUPS 登记分组即可，后台设置页会自动渲染。
未保存过的设置项不落库，读取时回落到默认值。

五、前台功能

搜索聚合：七种搜索引擎可切换，用户选择会带参数透传，站内搜索与外部引擎搜索在同一输入框完成。

权重查询（详情页）：展示各搜索引擎的权重等级（BR）、收录量与预估流量。支持三种数据源 —— 站长之家、接口盒子、自定义接口，可配置自动或手动触发，查询结果带缓存（默认 6 小时），失败时回退旧缓存并进入冷却期，避免反复打第三方接口。

信息自动抓取：输入网址后点击「自动获取」，服务端抓取目标站点的 <title>、description、favicon、og:image 并回填表单。前台投稿场景只填空字段、不覆盖用户手填内容；后台编辑场景直接覆盖（意图是刷新）。触发时机完全由按钮控制，失焦 / 回车均不触发。

六、后台功能

后台入口 admin/index.php，所有 AJAX 请求统一走后端接口（POST + 登录态 + CSRF 校验，响应结构 {code, msg, data}）。

自定义权重接口：在「自定义权重接口」设置组填写接口地址（支持 {domain} 占位）、请求方式、附加参数与请求头、成功判定条件、数据根路径、字段映射（每行 统一字段=返回字段路径，支持 list[0].Br 这类嵌套路径）。配置完成后可在后台直接做接口连通性测试，返回逐源明细与字段命中情况，不写缓存。

七、配置说明

config.php 返回一个数组，主要键：

站点名称、LOGO、备案号、SEO、列表条数、投稿开关、权重查询参数等运营配置不在 config.php，而是存在数据库 settings 表中，登录后台「系统设置」即可修改。

若 config.php 不存在，前台会自动跳转到 install.php 安装向导。

八、安全设计

九、运行环境与部署

环境要求

• PHP ≥ 7.4（推荐 8.1+），需启用 pdo_mysql（或 pdo_sqlite）、mbstring、curl、openssl
• Web 服务器：nginx + PHP-FPM（或 Apache）
• 数据库：MySQL 5.7+ / MariaDB 或 SQLite 3

部署步骤

1. 将项目文件放入站点根目录，确保 data/、uploads/ 可写。
2. 浏览器访问站点，按 install.php 向导填写数据库信息并创建管理员账号。
3. 安装完成后务必删除或重命名 install.php，防止被重复执行。
4. 配置 Web 服务器：将站点根指向项目目录；按上文「安全设计」补上目录封锁规则。
5. 登录后台，在「系统设置」中完善站点名称、LOGO、SEO 等信息。

性能与缓存

• 抓取结果、权重结果、限流计数均落盘缓存，减少外站请求。
• 前台资源通过版本号控制缓存；建议对 assets/ 设置较长过期时间。

十、版本与约定速查

改代码时的注意事项

1. 修改 assets/ 下的任何 CSS / JS 后，必须递增 XM_VERSION，否则浏览器会继续使用旧缓存。
2. 新增设置项只需改 Setting::DEFAULTS 与 Setting::GROUPS，无需改动数据库结构。
3. 新增数据表字段请在 Schema::upgrade() 中用 addColumnIfMissing() 追加，保证老库可平滑升级。
4. 任何出站 HTTP 请求必须先过 SSRF 校验，且禁止开启自动跟随重定向。

官方网站：http://5201317.xyz

演示截图：