适用版本:v1.01.001(帝国补全九轮交付版,PHP 8.1+ / MySQL / 零第三方依赖) 手册目录:
docs/乐悠悠CMS用户手册.md;后台「首页」提供入口卡 标注说明:★ 为「帝国补全九轮」新增功能(①~⑭ 对应交付编号)
第一章 系统简介
乐悠悠CMS 是一套零第三方依赖、纯自研的 PHP 内容管理系统,功能对标帝国 CMS,覆盖内容管理、会员、商城、互动、多语言与插件扩展。
核心能力一览
| 能力 | 说明 |
|---|---|
| 内容模型 | 自定义模型 + 字段,无限级栏目,专题 / TAG / 推荐位 |
| 全站静态化 | 前台 .tpl 模板编译后生成静态 HTML(storage/html),命中直出 |
| 商城 | 商品、订单、配送、优惠码、点卡、充值,支付宝 / 微信支付 |
| 会员 | 分组、积分、空间、收藏分类★⑤、站内信、整合通行证★⑩ |
| 互动 | 评论、留言、反馈、投票、顶踩、评分、错误报告 |
| 多站点 | 站点管理、访问端(PC / 移动)★⑧、栏目二级域名 |
| 扩展 | 插件机制★⑫、远程发布★⑨、采集对接(火车头)、多语言★⑪ |
技术规格
- 服务端:PHP ≥ 8.1(推荐 8.2+),必需扩展
pdo_mysql、mbstring;可选gd(验证码/水印)、ftp(远程发布) - 数据库:MySQL 5.7+ / 8.0(utf8mb4),101+ 张
lyy_前缀表 - 架构:自研 MVC(手工路由 + PSR-4 自动加载 + 自研 .tpl 编译引擎)
- 配置:
.env(参考根目录.env.example)
目录结构速览
| 目录 | 用途 |
|---|---|
app/ |
Controller / Model / Service / Lib 应用核心 |
public/ |
唯一 Web 根:前台 index.php、后台 lyyadmin/admin/、安装 install.php |
views/ |
后台与动态页视图 |
templates/ |
前台模板(default / mobile,.tpl) |
assets/ |
静态资源(css / js / img) |
storage/ |
运行时:html(静态页)/ upload / cache / backup / logs / tmp |
lang/ |
语言包(zh-cn、en 等) |
plugins/ |
插件目录 |
tools/ |
CLI 工具(cron / collect / migrate / upgrade SQL) |
sql/ |
全量建表 schema.sql |
docs/ |
项目文档与本手册 |
第二章 安装部署
2.1 环境要求
- PHP ≥ 8.1,启用
pdo_mysql、mbstring(GD、FTP 可选) - MySQL 5.7+ / 8.0,账号需有建库建表权限
- nginx / Apache 均可,Web 根指向
public/
2.2 安装向导 ★①
- 上传项目到服务器,确保 Web 根指向
public/ - 浏览器访问
http://你的域名/install.php(页面标题显示系统版本号,如"乐悠悠CMS v1.01.001 安装向导") - 环境自检:通过后方可继续(PHP 版本、PDO MySQL、mbstring;GD / FTP 缺失仅提示不阻断)
- 三步向导:
- 1. 数据库:主机 / 端口 / 库名 / 账号 / 密码(表前缀固定
lyy_) - 2. 站点:站点名称、站点地址
- 3. 管理员:管理员账号 / 密码
- 完成后自动写入
.env、执行建表与种子数据,并生成install.lock防重装 - 安全收尾:删除
public/install.php或在 nginx 追加location = /install.php { deny all; }
2.3 .env 配置说明
| 键 | 说明 |
|---|---|
DB_HOST/DB_PORT/DB_NAME/DB_USER/DB_PASS/DB_CHARSET |
数据库连接信息 |
SITE_URL |
站点地址(影响链接与静态化路径) |
ADMIN_PATH |
后台隐藏路径,默认 lyyadmin/admin |
UPLOAD_MAX_MB |
上传大小上限(MB) |
PAY_ALI_APP_ID / PAY_ALI_PRIVATE_KEY / PAY_ALI_PUBLIC_KEY |
支付宝 RSA2 凭据 |
PAY_WX_MCH_ID / PAY_WX_KEY / PAY_WX_APPID / PAY_WX_NOTIFY_URL |
微信 Native V2 凭据 |
支付凭据只放
.env,不入库不入 git;全部留空时自动回退 Mock 模拟支付(可走通流程便于测试)。
2.4 生产部署要点
- 参考
deploy/nginx.sample.conf:Web 根指public/,assets/与storage/upload/别名映射,其余 storage 子目录与.env均不可达 - PHP
post_max_size/ nginxclient_max_body_size需 ≥ 12M 以支持大附件 - 计划任务需配置 crontab(见第十一章)
第三章 后台快速入门
3.1 登录
- 后台地址:
http://你的域名/{ADMIN_PATH}/(默认/lyyadmin/admin/) - 登录页副标题显示系统版本号(如"内容管理系统 · 管理登录 · v1.01.001"),可据此核对部署版本
- 登录后如启用后台访问密码,还需输入一次访问密码方可进入
- 访问密码为帝国式四级:整站 / 后台 / 栏目 / 信息,在「系统设置 / 安全参数」与栏目 / 信息表单中分别设置;改密后加密栏目与信息的静态页自动清除,回退动态验证
3.2 后台首页
- 统计卡:信息总数 / 已发布 / 待审核 / 栏目数 / 附件数 / 总浏览量
- 快捷操作:发布信息、新增栏目、一键全站重建
- 运营趋势:近 30 天每日浏览量与发布量(内联 SVG)
- 最近操作:管理员操作日志
- 用户手册入口卡:提示文档位置(
docs/乐悠悠CMS用户手册.md)并提供「模板变量说明」直达按钮 - 后台任意功能页页脚显示系统版本号("乐悠悠CMS v1.01.001")
3.3 界面风格 ★⑭
进入「管理员 → 改密页 → 界面风格」,可设置:
- 主题:default / dark
- 自定义 CSS / JS(各 ≤ 50000 字符,JSON 校验)
自定义 CSS/JS 仅注入本人后台页面,属个人配置;请仅使用可信代码。
3.4 菜单结构(10 组)
| 分组 | 主要功能 |
|---|---|
| 常用菜单 | 后台首页 / 网站首页 / 增加信息 / 管理信息 / 数据更新 / 系统设置 |
| 系统管理 | 系统设置、站点管理、访问端★⑧、防火墙、计划任务、管理员、用户组权限、操作/登录日志、菜单管理、扩展变量、分类管理、安全参数 |
| 信息管理 | 信息管理、工作流审批、工作流设置、敏感词管理 |
| 栏目管理 | 栏目、模型与字段、专题、TAG、标题分类、推荐级别、自定义单页、自定义列表、推荐位、公告、友情链接、碎片、广告(位/统计)、信息来源、作者、下载前缀 |
| 模板管理 | 模板管理、模板市场、模板变量、模板修改记录、变量说明、标签管理 |
| 会员管理 | 会员管理、会员分组字典、会员消息、站内信模板、会员空间、空间留言 |
| 插件工具 | 附件管理、远程发布★⑨、插件管理★⑫、下载记录、批量替换、模板批量替换、SQL 执行(留痕)、数据库优化/备份、附件地址替换、重复信息检测、播放器、数据整理、文件管理器、采集节点 |
| 商城管理 | 商品、订单、配送方式、优惠码、支付设置、点卡、充值类型/记录 |
| 互动管理 | 评论、留言、反馈、投票、错误报告、搜索统计、信息排行、搜索关键字、栏目统计、工作量统计、全站统计汇总 |
| 扩展功能 | 数据更新、数据迁移、分表管理 |
- 左菜单支持折叠(cookie 记忆);「扩展菜单 / 常用菜单」两组可自定义追加(「菜单管理」页维护,支持外链新窗口)
- 全部功能可在「系统管理 → 后台地图」一页总览直达
- 权限:超管全显;普通管理员按用户组权限位过滤菜单与功能