快速上手:系统简介 · 安装部署 · 后台入门

2026-11-21 · 浏览 4

适用版本: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 安装向导 ★①

  1. 上传项目到服务器,确保 Web 根指向 public/
  2. 浏览器访问 http://你的域名/install.php(页面标题显示系统版本号,如"乐悠悠CMS v1.01.001 安装向导")
  3. 环境自检:通过后方可继续(PHP 版本、PDO MySQL、mbstring;GD / FTP 缺失仅提示不阻断)
  4. 三步向导:
  5. 1. 数据库:主机 / 端口 / 库名 / 账号 / 密码(表前缀固定 lyy_)
  6. 2. 站点:站点名称、站点地址
  7. 3. 管理员:管理员账号 / 密码
  8. 完成后自动写入 .env、执行建表与种子数据,并生成 install.lock 防重装
  9. 安全收尾:删除 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 / nginx client_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 记忆);「扩展菜单 / 常用菜单」两组可自定义追加(「菜单管理」页维护,支持外链新窗口)
  • 全部功能可在「系统管理 → 后台地图」一页总览直达
  • 权限:超管全显;普通管理员按用户组权限位过滤菜单与功能

页次:1/1 每页1 总数1    首页  上一页  下一页  尾页    转到:
下载乐悠悠CMS 联系我们