玄灵云商城系统是一款基于自研PHP框架构建的轻量级可插拔SaaS应用。系统采用模块化设计理念,以插件化架构为核心,提供高度灵活的业务扩展能力,适用于虚拟商品销售、会员充值、数字卡密分发等多种电商场景。安装也很简单,本文是详细的安装教程。
API文档:https://xmall.apifox.cn/
MCP:
{
"mcpServers": {
"玄灵云商城 API - API 文档": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"apifox-mcp-server@latest",
"--site-id=5461260"
]
}
}
}
玄灵云商城测试站:https://demo-mall.xuanling.cn/
后台:/admin
后台前台统一账号密码:
账号:admin
密码:xuanling
选择云服务器
推荐Linux系统云服务器,各大平台有售,要求至少2核2G。
本司云服务器选购:https://cloud.xuanling.cn/cart
![图片[1]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314193432648-image.png)
环境准备
在部署商城系统之前,需要确保服务器上已经安装了必要的环境和工具。以下是该商城基本的环境要求:
- 操作系统:推荐使用Debian 12,Ubuntu 22,Centos 9及以上版本。
- Web服务器:安装Nginx或Apache。
- PHP:安装PHP 7.4及以上版本。
- 数据库:安装MySQL 5.6及以上版本。
- 缓存:安装Redis以提高系统性能。
关于PHP,你必须为其安装基本扩展:
| 扩展名 | 用途 |
|---|---|
| PDO | 数据库抽象层 |
| pdo_mysql | MySQL数据库驱动 |
| pdo_sqlite | SQLite数据库驱动 |
| json | JSON编码解码 |
| mbstring | 多字节字符串处理 |
| openssl | SSL加密、签名验证 |
| curl | HTTP网络请求 |
| zip | ZipArchive压缩解压 |
| session | 会话管理 |
| filter | 变量过滤验证 |
| hash | 哈希算法(HMAC-SHA256等) |
| pcre | 正则表达式 |
| reflection | 反射API |
| spl | 标准PHP库(迭代器等) |
| simplexml | XML解析 |
| dom | DOM文档处理 |
| ctype | 字符类型检测 |
| stream | 流处理(SMTP邮件) |
可选PHP扩展:
| 扩展名 | 是否必需 | 用途 |
|---|---|---|
| gd | 可选 | 图形验证码生成 |
| bcmath | 可选 | 高精度数学计算(微信支付证书序列号解析) |
| sodium | 可选 | 现代加密库(微信支付AES-GCM解密备用) |
| gmp | 可选 | 高精度数学计算(MaxMind IP库备用) |
| exif | 可选 | 图像类型检测(文件验证备用) |
当然以上必须安装的PHP扩展在一些面板安装时,会默认自自带,仅可选部分需要自行安装。
推荐使用宝塔作为运维面板安装教程:https://wxsnote.cn/360.html
宝塔面板安装登录后,会推荐选择安装基本项,按需求选择后,会安装如图以下:
![图片[2]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314195018216-image.png)
安装Redis及PHPRedis扩展。
![图片[3]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314195428599-image.png)
安装商城系统
解析域名
将域名解析到服务器IP:https://wxsnote.cn/4551.html
创建网站
在基本环境准备好后,开始创建网站,一般只需要在添加站点中填写域名,开启数据库即可,如图顺序操作。
![图片[4]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314194907342-image.png)
进入网站根目录。
![图片[5]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314195827501-image.png)
全选删除文件,删除后仅会保留.user.ini。
![图片[6]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314195922297-image.png)
部署程序压缩包
凭获取的产品激活密钥下载程序压缩包,前两种是新用户,最后一种是已授权老用户
前往玄灵云商城下载页下载
![图片[8]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260315124207399-image.png)
已经授权的用户,由于产品激活码已经使用,失效的缘故,可在我的站点,详情中下载安装包,以及管理修改域名
![图片[9]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317140042751-image.png)
下载后,将程序压缩包拖入网站根目录上传,或是其它方式上传。
![图片[10]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314200045148-image.png)
点击压缩包更多按钮的解压。
![图片[11]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314200148458-image.png)
确保解压目录权限为755,填写解压密码,也请在解压时输入,解压后,压缩包就可以删除了。
![图片[12]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314200303758-image.png)
在解压后,再次设置一遍,新版宝塔有bug,可能导致后续使用有问题
![图片[13]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317121916527-image.png)
设置运行目录
设置网站PHP脚本运行目录,选择后点击保存,切记是public目录,
![图片[14]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314200601461-image.png)
设置伪静态
设置伪静态,Nginx适用于宝塔及本文,Apache也就一些虚拟主机,康乐面板在使用的Web服务器了。
location / {
try_files $uri $uri/ /index.php$is_args$query_string;
}
<IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
Options -MultiViews -Indexes
</IfModule>
RewriteEngine On
# Handle Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
</IfModule>
![图片[15]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314200812896-image.png)
配置SSL证书
SSL证书,这个建议在建站初期就直接使用,不建议运营后再添加,因为涉及到协议改变。
推荐一些工具:
- ALLinSSL:https://allinssl.com/
- 彩虹聚合DNS管理系统:https://github.com/netcccyun/dnsmgr
使用以上项目,支持自动免费申请并自动更新SSL证书。
![图片[16]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314201111565-image.png)
配置后,你的网站在浏览器就不会提示链接不安全了,同时也保障网页内容不被篡改,要开启强制HTTPS,但请注意CDN等的协议,要选择跟随,若是两处都开启强制HTTPS会导致无限301,无法访问网站。
![图片[17]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314201603457-image.png)
WAF关闭弱密码
在安装后,由于默认密码是123456,所以需要临时关闭弱密码,在您修改密码后可再次打开。
![图片[18]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317121632595-99bbf4eaf5aa16ad27dfefe631fea88e.png)
激活产品
访问网站域名,会自动跳转到激活页。
![图片[19]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314204239759-image.png)
点击快捷登录,可以登录或注册,用于绑定,此平台可以方便您管理授权。
您也可先注册,再进入绑定页:https://mall.xuanling.cn
![图片[20]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314204419887-image.png)
确认授权即可绑定成功。
![图片[21]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314204912727-image.png)
自动回到您的网站中,此时输入您获取到的产品密钥即可激活产品,若暂未获取可在关于我们页面获取到联系方式。
![图片[22]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314204946124-image.png)
安装商城系统
勾选同意协议,下滑并仔细阅读本程序的全部许可协议。
![图片[23]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314205248322-image.png)
第一步环境检查一般是没问题的,如有问题请联系客服反馈,来到安装向导第二步,填写数据库及配置开关。
![图片[24]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314205558605-image.png)
数据库名,数据库用户名,数据库密码,都可在宝塔面板数据库MySQL页找到。
![图片[25]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314205430582-image.png)
配置Redis
配置Redis,此项可选,首先确保您的服务器已经安装Redis及PHPRedis扩展。在勾选后,点配置打开设置页,填写IP,端口等,一般都是默认的。若是没有改动过,直接与图中一致即可。
![图片[26]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314205820877-image.png)
关于Redis数据库下标,就是Redis为了防止缓存数据窜站而设计的,你在填写时,若有多个网站使用了Redis服务器。建议选一个为空的库,如下图,共有16个库(0到15),也就是说数据库下标可填写0到15数字。
![图片[27]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314210149981-image.png)
第三步就为数据库安装好表了,记住默认账号密码,前往管理后台即可。
![图片[28]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314210616633-image.png)
记住后台登录地址,账号密码在登录后可以自行修改。
![图片[29]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260314210730519-image.png)
必要操作
1.计划任务
前往定时任务开启任务,并点击更多,进程守护,查看监控API。
![图片[30]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260315103040398-image.png)
复制监控地址。
![图片[31]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260315103215733-image.png)
任务类型选择get,填写监控地址,设置执行周期。
![图片[32]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260315103457743-image.png)
如果是使用的是推荐环境搭建,你可以设置任意频率,甚至24小时一次,它的存在不是执行任务,是探针,只是守护监控进程是否在运行中。举个例子,就是怕它打瞌睡,过一段时间看看它是否睡着了,睡着就叫醒它。
说一下为什么要监控,这种设计起源可追溯至1975年,一直存留至今。在web商城系统中,首要目的就是把慢业务从用户访问流程里剥离出去,不让访客体验到卡顿、等待、超时,总结就是业务解耦+提速防抖。任何需要提升用户体验的程序都有内置,有的是隐性的,有的则是本程序中这种显性的,看不到不代表没有。例如二进制程序可能无需手动设置计划任务,因为他是常驻系统进程。但PHP脚本不同,因为他是一次性执行,结束即销毁,不是常驻任务,这可以减少内存及CPU算力的占用,这就是监控的原因。
2.插件模板应用的使用
需要在应用列表手动开启及设置应用,注意有多页
![图片[33]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317122822444-image.png)
3.模板设置
选择各个客户端的模板样式,及各种客户端是否开启
![图片[34]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317122518990-image.png)
在应用列表设置主题的各种信息
![图片[35]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317122640804-image.png)
4.设置
在系统管理,通用设置中,可设置各种内容,及应用设置。
站点设置,用户设置,功能,合规信息,快捷键偏好等
![图片[36]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260317123251937-image.png)
后续可选配置
1.CDN设置
CDN设置为跟随源站,源站服务器设置强制301到https,请务必注意,必须源站和CDN都部署SSL证书。
基本规则:
- HTTP头部缓存 关闭
- 节点缓存过期规则(全部文件 全部静态文件 遵循源站 不忽略参数)
- 文件后缀
phphtml不缓存 - 目录规则
/admin/api不缓存
![图片[37]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260315110604636-8f1ca5f8b8f2b3a2dd520974e90456ca.png)
总结
通过以上步骤,你可以在云服务器上成功部署商城系统,希望本文能帮助你快速搭建一个高效、稳定的电子商务平台,为你的业务发展提供有力支持。


![图片[7]-玄灵云商城系统安装教程-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/04/20260315124448693-image.png)




![玄灵云商城-最新版V1.0.0已更新[2026-03-15][更新日志]-玄灵社区](https://bbs.xuanling.cn/wp-content/uploads/2024/06/20240624224141583-4fe01526912fa617c71ab23219ca5156_720.png)



请登录后查看评论内容