安装部署

环境要求

项目要求推荐
PHP版本>= 7.48.0 / 8.1
MySQL版本>= 5.78.0
Web服务器Nginx / ApacheNginx
PHP扩展fileinfo, curl, gd, mbstring, openssl, pdo_mysql

安装步骤

  1. 上传文件:将程序包解压后上传到服务器网站目录
  2. 设置目录权限:确保 writable 目录可写(chmod 755)
  3. 配置网站根目录:将网站根目录指向 public 文件夹
  4. 访问安装向导:浏览器访问网站域名,自动进入安装界面
  5. 填写配置信息:按提示填写数据库信息和管理员账号
  6. 完成安装:点击完成,系统自动创建数据表并初始化

Nginx配置

server {
    listen 80;
    server_name your-domain.com;
    root /www/wwwroot/your-site/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-80.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(ht|git|env) {
        deny all;
    }
}
提示:宝塔面板用户可直接在网站设置中配置伪静态规则,选择"CodeIgniter4"即可。

系统配置

基础设置

登录后台 /admin,进入"系统设置"进行配置:

配置项说明
网站名称显示在浏览器标题和页面头部
网站Logo支持上传图片,建议尺寸200x50
网站URL完整的网站地址,用于生成链接
ICP备案号显示在页面底部
统计代码百度统计、CNZZ等第三方统计代码

SEO设置

  • 网站标题:首页的title标签内容
  • 关键词:meta keywords,多个用逗号分隔
  • 描述:meta description,建议80-150字

缓存设置

系统支持文件缓存,可在后台开启/关闭,并设置缓存时间。建议生产环境开启缓存以提升性能。

内容管理

小说管理

  • 添加小说:填写书名、作者、简介、封面等信息
  • 章节管理:支持单章添加和批量导入
  • 付费设置:可设置免费章节数、单章价格、VIP免费
  • 状态管理:连载中/已完结/暂停更新

漫画管理

  • 添加漫画:支持条漫和页漫两种模式
  • 章节图片:支持批量上传,自动排序
  • 阅读模式:滚动阅读/翻页阅读

视频管理

  • 添加视频:支持剧集和单集两种类型
  • 播放源:支持本地上传、外链、m3u8等
  • 剧集管理:多集视频的分集管理

分类与标签

每种内容类型都有独立的分类和标签系统,可在后台自由配置。

用户系统

注册登录

  • 支持用户名、邮箱、手机号注册
  • 可配置是否需要验证码、邮箱验证
  • 支持第三方登录(QQ、微信、微博)

用户等级

等级权限
普通用户阅读免费内容、评论、收藏
VIP会员免费阅读VIP内容、专属标识
认证作者发布作品、获取收益

虚拟货币

系统使用"金币"作为虚拟货币,用户可通过充值获得,用于购买付费章节。

作者中心

作者入驻

  1. 用户在前台申请成为作者
  2. 填写真实姓名、身份证、联系方式
  3. 后台审核通过后获得作者权限

作品管理

作者可在前台作者中心管理自己的作品:

  • 创建/编辑小说、漫画、视频
  • 管理章节内容
  • 查看阅读数据和收益统计

收益结算

  • 分成比例:可在后台配置作者分成比例(默认70%)
  • 提现申请:作者可申请提现,后台审核后打款
  • 收益明细:详细的收益记录和统计

支付配置

易支付配置

系统支持易支付(彩虹易支付等),配置步骤:

  1. 在易支付平台注册商户账号
  2. 获取商户ID、商户密钥、接口地址
  3. 在后台"支付设置"中填入配置信息
  4. 开启需要的支付方式(支付宝、微信等)
配置项说明
接口地址易支付平台提供的API地址
商户ID您的商户编号
商户密钥用于签名验证的密钥

充值配置

在后台设置充值金额档位和对应的金币数量,可设置赠送金币。

VIP价格

设置不同时长VIP的价格:月卡、季卡、半年卡、年卡。

AI功能配置

支持的AI服务

  • 硅基流动:国内AI服务,支持对话、图像生成
  • OpenAI:ChatGPT、DALL-E等
  • 火山引擎:字节跳动AI服务

配置步骤

  1. 在对应AI平台注册账号并获取API Key
  2. 后台进入"AI设置"
  3. 填入API Key和选择模型
  4. 测试连接确保配置正确

AI功能列表

功能说明
AI写作助手辅助创作小说内容
AI大纲生成自动生成故事大纲
AI封面生成根据描述生成封面图
AI配音文字转语音功能

模板开发

模板目录结构

public/template/pc/模板名/
├── html/           # 模板文件
│   ├── index.html  # 首页
│   ├── head.html   # 公共头部
│   ├── header.html # 导航
│   ├── footer.html # 页脚
│   └── ...
├── css/            # 样式文件
├── js/             # 脚本文件
├── images/         # 图片资源
└── tpl.php         # 模板配置

常用模板标签

标签说明
漫主CMS-AI管理系统网站名称
https://mzcms.com/网站地址
[mzcms_logo]网站Logo
漫主CMS - 专业的漫画小说内容管理系统 引入公共head.html
引入公共header.html
引入公共footer.html
引入公共bottom.html

数据循环标签

[list:comic num=10 order=addtime]
<div class="item">
    <a href="[url]">[title]</a>
    <img src="[pic]">
</div>
[/list:comic]

条件判断标签

[if vip=1]
    VIP专属内容
[else]
    普通内容
[/if]

API接口

接口地址

所有API接口以 /appv1/ 为前缀,支持GET和POST请求。

通用返回格式

{
    "code": 1,        // 1成功,0失败
    "msg": "success", // 提示信息
    "data": {}        // 返回数据
}

主要接口列表

接口说明
/appv1/login用户登录
/appv1/login/reg用户注册
/appv1/comic/index漫画首页数据
/appv1/comic/info漫画详情
/appv1/comic/chapter章节列表
/appv1/comic/read阅读内容
/appv1/book/index小说首页数据
/appv1/book/info小说详情
/appv1/user/index用户信息
/appv1/fav/add添加收藏
/appv1/pay/init发起支付
注意:部分接口需要登录后才能访问,请在请求头中携带token参数。