开发文档

一、环境要求

• PHP 7.4 及以上（官方推荐；演示站跑 PHP 8.3 正常）；MySQL 5.7+（utf8mb4）；
• PHP 扩展：pdo_mysql、mbstring、curl、gd（图标/缩略图）、zip、openssl、fileinfo；
• 需要伪静态（URL Rewrite）：随包 伪静态规则/ 下提供 Nginx 与 Apache 规则，照抄到站点配置即可（不配的话首页能开、分类/详情页全 404）；
• 可写目录：uploads/、cache/、logs/、backups/、程序根（安装时要写配置）。

二、安装步骤

1. 把安装包里的 yuansheng-nav/ 目录内容全部上传到网站根目录（让 index.php 直接在站点根）；
2. 建好数据库（utf8mb4），记住库名 / 账号 / 密码；
3. 浏览器访问 http://你的域名/install/，按向导填数据库信息 + 站点名称 + 后台管理员账号；
4. 安装完成会生成配置与 install.lock；（重要）到站点配置里把 /install/ 目录屏蔽或删除——演示站的 Nginx 规则里是 location ~* ^/install/ { return 404; }；
5. 配置伪静态（见上），完成后测试首页、分类页、站点详情页都能打开；
6. 后台入口：/admin/login.php（登录带滑块验证）。

三、安装后必做

• 站点设置：站点名称/SEO 标题关键词描述/客服 QQ 微信/ICP 备案号/版权信息/统计代码/违禁关键词/默认拒绝原因；
• 支付配置：易支付（支付宝 / 微信）的接口地址、商户 ID、密钥（用于广告位投放、付费推荐、资源下载、会员充值）；
• 邮件 SMTP：注册验证码、收录通知都要用（后台 → 邮件设置）；
• 分类与站点：建好分类（支持二级）→ 添加/审核站点 → 后台可「批量抓取」自动取站点信息与图标；
• 计划任务（建议都加上）：

# 每分钟/每 5 分钟
php /站点路径/ai_review_cron.php      # AI 审核队列
php /站点路径/site_check_cron.php     # 站点可用性巡检
php /站点路径/ad_cron.php             # 广告位到期下架

• 广告位：后台「广告管理」配置广告位后点「批量生成」，前台才会出现广告位（可在线购买投放）；
• 模板：后台可切换模板；改模板先复制一份（升级不覆盖你自己的目录）。

四、常见问题

• 首页能开、其它页 404：伪静态没配（最常见！照抄 伪静态规则/nginx伪静态.txt）；
• 装完提示重新安装 / 一直跳 install：install.lock 没生成或根目录不可写；
• 上传图标/图片失败：uploads/、cache/ 权限不足（755，属主设为 PHP 运行用户）；
• 后台样式错乱：assets/ 没传全，或后台入口不是从 /admin/ 访问；
• 不能改某些后台文件：后台登录/配置/AJAX/分类管理等 6 个文件是官方加密发行版，属正常现象；二开请在旁边新增文件实现；
• 站点巡检/AI 审核不跑：计划任务没加（见上），或 PHP CLI 路径不对。

五、安全建议

• 安装完删 /install/，后台路径可自行改名（改完记得同步任何引用）；
• 后台开启强密码；程序自带登录失败锁定、滑块验证与访问频率限制（ys/security.php）；
• 定期在后台「数据库备份」做备份（写 backups/），并备份 uploads/；
• 包内《使用前必看》为程序作者随包说明，请保留（作者请求转载时不要删除该文件）。