uni-app共享农场/NFT元宇宙系统搭建实录与二次开发笔记
声明:本文仅供技术学习参考,不构成任何投资建议或运营指导;任何实际部署必须遵守当地法律法规,禁止用于任何违法违规用途。
最近帮客户部署了一套uni-app共享农场+NFT元宇宙演示系统,后台用PHP,前端uni-app。源码完全开源,还带了二开文档,非常适合拿来做农业养成类、数字资产展示类的技术原型。刚拿到这套源码时名字挺唬人,拆完之后发现核心就是模拟养成+任务分发+道具合成。记录一下从环境准备到上线测试的全过程,方便自己也方便后来人。

功能实测:后台与前端怎么配合
后台管理模块
后台是标准的PHP管理端,主要菜单包括会员管理、农场/牧场模块、道具商店、任务分发、收益模拟、支付接口开关、多语言设置、公告Banner和系统日志。权限这块做了角色分级,普通管理员只能看数据,超级管理员才能改配置、删会员。支付接口只建议接入正规合规的通道,测试阶段我会先关闭真实回调,改成模拟支付模式,避免误扣款。
农场与牧场养成逻辑
土地开垦、播种、浇水、除虫、收获这条链路走得通。每种作物在后台可配置生长周期、产量、售价和经验值。牧场部分可以喂养动物、收集产物,产物进仓库后再出售或合成高级道具。时间和产出参数都能在后台调,测试时我把成熟时间设成1分钟,方便快速验证。

NFT/数字藏品展示模块
道具和动物以卡片形式展示,支持图片、名称、稀有度、描述等元数据。后台配置完,前端uni-app会按分类渲染。这个模块很适合改成数字资产演示平台,比如展示虚拟种子、限定农具,而不是做真实的金融交易。前端页面用了瀑布流布局,加载速度还可以。
多语言与主题切换
后台自带语言包管理,前端uni-app配合vue-i18n实现切换。默认有中文和英文两版,新增语言时复制一份语言包JSON,改key和值就行。主题色可以在uni.scss里统一替换。
部署要点:从源码到可访问
服务器环境
后端跑PHP 7.4或8.0,MySQL 5.7,Nginx/Apache都能用。PHP扩展要开mysqli、pdo_mysql、gd、fileinfo、openssl。伪静态规则按ThinkPHP或原生路由配,具体看你拿到的目录结构。建议用宝塔面板快速搭LNMP,省事。

源码安装步骤
解压后一般分为admin后台、api接口、uni-app前端三个目录。先导入数据库SQL文件,再改后台config里的数据库账号、密码、Redis地址和域名。管理员默认账号密码一般在install说明里,第一次登录后立刻改密码。如果部署到子目录,要注意接口地址和静态资源路径的拼接,这里最容易出现图片加载失败。
前端打包踩坑
前端用HBuilder X导入,先配manifest.json里的appid和接口域名。H5发布时路由模式建议选hash,不然刷新会404。跨域问题在Nginx里加Access-Control-Allow-Origin头,或者让前端代理到API域名。小程序和APP端也可以一起打包,但小程序需要配置合法域名。
支付接口与安全
正式环境对接支付前,务必走沙箱或模拟支付流程。检查回调签名校验、HTTPS证书、后台登录强密码和SQL注入过滤。后台登录路径建议改默认地址,再加IP白名单。数据库定期备份,重要配置不要写死在前端。
亮点提示:这套系统的二开文档比较完整,核心表结构、API返回格式、uni-app页面路由都列出来了。做任务分发或数字资产展示Demo时,直接复用现有逻辑能省不少时间。
适合人群与二开方向
这套源码适合有PHP或uni-app基础的技术团队、学生毕设、农业文旅数字化Demo。可二开的方向包括:智慧农业认养平台、乡村旅游积分系统、数字藏品展示页、任务分发系统、企业内部虚拟激励平台。农业主题天然适合做养成、签到、兑换这些玩法,改起来不费劲。

常见问题
问:前端打包后白屏怎么办?
答:检查manifest.json里H5路由模式是否为hash,接口域名是否配了HTTPS,以及浏览器控制台有没有CORS报错。本地测试建议用HBuilder内置浏览器,正式发布再配正式域名。
问:后台登录不了,提示权限不足?
答:先确认数据库已完整导入,管理员账号密码在install说明里。如果auth_rule权限表数据缺失,重新执行初始化SQL,或者清理runtime缓存。
问:支付回调测试时收不到异步通知?
答:确保服务器外网可访问,回调地址没有index.php重写问题。Nginx建议配try_files $uri $uri/ /index.php?$query_string。本地开发可用内网穿透工具暴露回调地址。
问:想增加一种语言怎么操作?
答:后台语言包管理处添加key,前端locales目录下新建对应JSON文件,页面里用$t调用。修改后重新编译H5或小程序即可生效。
免责声明:本技术分享仅供学习交流参考,使用该系统必须遵守相关法律法规,禁止任何违法违规用途。
声明:本文仅供技术学习参考,不构成任何投资建议或运营指导;任何实际部署必须遵守当地法律法规,禁止用于任何违法违规用途。
-
Alipay QR Code Scan
-
WeChat Scan Pay