介绍

XuanCMS 是一个基于 Laravel + Layui 开发的现代化社区商城系统

系统特点

  • 模块化设计,易于扩展
  • 完整的社区功能
  • 强大的商城系统
  • 灵活的权限控制

技术架构

XuanCMS/
├── app/
│   ├── Http/
│   ├── Models/
│   └── Services/
├── bootstrap/
├── config/
├── database/
├── lang/
├── public/
├── resources/
│   ├── views/
│   │   ├── admin/
│   │   ├── errors/
│   │   ├── home/
│   │   ├── plugins/
│   │   │   ├── default/
│   │   ├── themes/
│   │   │   └── default/
│   │   └── install/
│   ├── js/
│   ├── css/
│   ├── sass/
│   └── lang/
├── routes/
├── storage/
├── tests/
├── vendor/
├── .editorconfig
├── .env
├── .env.example
├── .gitattributes
├── .gitignore
├── .htaccess
├── .styleci.yml
├── artisan
├── composer.json
├── composer.lock
├── nginx.htaccess
├── package.json
├── phpunit.xml
├── pubspec.yaml
├── README.md
└── webpack.mix.js

目录说明

  • app/ - 应用核心代码目录
  • bootstrap/ - 框架启动和自动加载设置
  • config/ - 应用配置文件
  • database/ - 数据库迁移和填充文件
  • lang/ - 多语言文件
  • public/ - 公共资源目录
  • resources/ - 前端资源和视图文件
    • views/ - 视图模板文件
      • admin/ - 后台管理视图
      • errors/ - 错误页面模板
      • home/ - 前台页面视图
      • plugins/ - 插件视图目录
      • themes/ - 主题模板目录
      • install/ - 安装向导视图
  • routes/ - 路由定义
  • storage/ - 文件上传、缓存等
  • tests/ - 测试文件
  • vendor/ - Composer 依赖

快速开始

下载安装包

最新版本:v1.0.0

发布日期:2025-01-04

环境要求

  • PHP >= 7.4.0
  • MySQL >= 5.7
  • 必需扩展:
    • pdo_mysql
    • openssl
    • mbstring
    • xml
    • ctype
    • json
    • bcmath

系统安装

访问域名,根据安装向导完成安装:

1. 环境检测

  • PHP版本检测
  • 扩展检测
  • 目录权限检测

2. 数据库配置

  • 数据库地址
  • 数据库名称
  • 用户名和密码
  • 数据库端口

3. 系统安装

  • 连接数据库
  • 创建数据表
  • 导入初始数据
  • 完成安装

默认账号

  • 后台地址: /admin/login
  • 管理员账号: admin
  • 管理员密码: admin888
为了系统安全,请在登录后立即修改默认密码!

插件开发

插件结构

plugins/
└── your_plugin/              # 插件目录
    ├── assets/               # 静态资源目录
    │   ├── css/             # CSS文件
    │   └── js/              # JavaScript文件
    ├── migrations/          # 数据库迁移文件
    │   └── 2025_01_06_182803_create_your_plugin_tables.php
    ├── views/               # 视图文件目录
    │   ├── admin/          # 后台视图
    │   │   └── setting.blade.php  # 插件设置页面
    │   └── home/           # 前台视图
    ├── config.json         # 插件配置文件
    └── Plugin.php          # 插件主类文件

主要文件说明

  • config.json - 插件基本信息配置文件,包含插件名称、版本、作者等信息
  • Plugin.php - 插件的主类文件,包含安装、卸载等核心方法
  • views/admin/setting.blade.php - 插件后台设置页面模板
  • migrations/ - 存放数据库迁移文件
  • assets/ - 存放CSS、JavaScript等静态资源文件

创建插件

系统提供了便捷的命令行工具来创建插件基础结构:

php artisan make:plugin your_plugin_name

执行命令后,系统会引导您完成插件的基本信息配置:

请输入插件标题: [your_plugin_name]
请输入插件描述: [这是一个新插件]
请输入插件版本: [1.0.0]
请输入作者名称: [输入作者名称]

填写完成后,系统会自动:

  • 创建标准的插件目录结构
  • 生成必要的基础文件
  • 配置插件信息
插件名称请使用小写字母、数字和下划线的组合,例如:user_center、shop_system
目录
开发者文档 - XuanCMS - 新一代社区商城系统