简介这份WiFi大师小程序3.0.9独立版源码面向小程序开发者、副业创业者及希望研究分销裂变模式的技术人员核心解决的是如何搭建一套可独立部署的WiFi分销小程序让商家免费WiFi通过用户扫码连接产生流量主分成实现商家、用户与运营者三方共赢。压缩包共约2000个文件体积18.72MB以1182个PHP后端文件为主体配合130个JS脚本、114个JSON配置、86个WXSS与85个WXML页面结构另有PNG、JPG、GIF等图片素材及SQL建表文件前后端与数据库结构相对完整。目前已有443人学习下载属于较新的3.0.9独立可学习版本。读者可从中获取完整的小程序前端页面、后端接口逻辑、数据库脚本与配置示例便于二次开发、功能拆解或学习分销返利与流量主对接思路适合具备一定PHP与小程序基础的中高级开发者参考研究。1. 扫码连 Wi-Fi 还能跑分销这套 3.0.9 独立版源码到底能落地什么前阵子帮一个做本地生活服务的朋友看需求他想在商圈里铺一套「扫码连 Wi-Fi、流量主分成」的小程序找了一圈现成方案要么是 SaaS 按年收费、数据全在别人服务器上要么是功能残缺、连分销结算逻辑都没有。后来翻到这套 WiFi 大师小程序 3.0.9 独立版源码才算把「独立部署 分销分账」这条链路跑通。它本质上是一套微信小程序前后端源码核心解决三件事用户扫码免密连 Wi-Fi、商家 Wi-Fi 变成流量入口、平台按流量主模式给商家和推广员分账。适合谁适合手里有本地商家资源、想自己掌控数据和结算的开发者或小团队不适合只想开箱即用、完全不懂后端部署的人。下面我按「这套源码是什么结构 → 怎么部署跑起来 → 分销逻辑怎么配 → 坑在哪」的顺序拆一遍能照着复现。2. 源码结构拆解从 var-dump-server.bat 到 amazeui 的目录逻辑拿到压缩包先别急着往服务器扔花十分钟把目录结构看清楚后面部署能省掉一半的返工。这套源码的文件命名其实暴露了它的技术底子我按实际解压后看到的层级来说。2.1 前端资源层amazeui 多套 css 的拼装方式解压后前端部分能看到amazeui.min.css、app.css、diy.css、style.css、style.min.css、layer.css这一串样式文件。这里有个细节值得说amazeui.min.css是 Amaze UI 这个老牌移动端框架的压缩版说明前端 UI 底座用的是它而app.css和style.css各出现了两次、style.min.css也重复这不是打包错误而是不同页面模块各自引了一套开发时大概率是多人协作、样式没做统一收敛。diy.css从命名看是「自定义装修」相关对应小程序里商家可配置的页面样式layer.css是 layer 弹层组件的样式用在弹窗提示、确认框这类交互上。实际改样式时我的建议是只动diy.css和app.css别去碰amazeui.min.css和任何.min.css压缩文件改起来容易出错而且升级时会覆盖。判断一个页面用了哪套样式直接搜页面文件里的link或import引用即可。常见做法是# 在源码根目录统计各 css 被引用的次数快速定位主样式 grep -rn style.min.css ./ --include*.html --include*.wxml | wc -l grep -rn diy.css ./ --include*.html --include*.wxml第一条命令数出style.min.css被多少页面引用数字大说明它是全局主样式第二条定位diy.css用在哪些装修页面。参数上--include限定文件类型避免把图片、日志也扫进来。这一步做完你心里就有张「改哪个文件影响哪些页面」的 map 了。2.2 后端与调试层var-dump-server.bat 说明了什么var-dump-server.bat这个文件是判断技术栈的关键线索。它是 Symfony 框架自带的 VarDumper 组件配套的调试服务启动脚本Windows 批处理格式。看到它基本可以确定后端是 PHP且用了 Symfony 或至少引入了 Symfony 的调试组件。这意味着两件事。第一部署环境需要 PHP 运行环境版本上 Symfony 的 VarDumper 对 PHP 版本有要求常见做法是 PHP 7.2 以上具体看composer.json里的约束。第二这个.bat是开发调试用的生产环境不该带着它跑正式部署时应该关掉 debug 模式否则会暴露变量结构甚至路径信息。后端目录一般会有config、src、public、vendor这几块。public是 Web 入口src是业务代码分销结算的逻辑大概率在src下的 Service 或 Controller 里。找分账逻辑的入口可以这样搜# 定位分销/分账相关业务代码 grep -rn 分销\|分账\|commission\|distribut ./src --include*.php -l-l参数只输出文件名不输出内容先拿到文件清单再逐个打开看比一上来就刷屏强。这一步是后面配分销比例的基础找不到业务文件参数就无从改起。2.3 独立版和 SaaS 版的核心差别「独立版」这三个字是这套源码的价值点。SaaS 版是你租别人的系统商家数据、用户数据、结算流水都在服务商那里你只是个渠道独立版是把整套代码部署到你自己的服务器数据库也是你自己的。差别体现在三处数据归属、结算自主、二次开发自由度。数据归属上独立版的用户 openid、连接记录、分成流水都进你自己的库做后续运营分析不用求人。结算自主上分账比例、结算周期这些参数在代码和数据库里你能按每个商家的合同单独配。二次开发上你可以加自己的功能模块比如对接本地的生活服务平台。代价是运维得自己扛服务器、域名、SSL、小程序审核都得自己走一遍。所以选独立版之前先问自己有没有稳定的服务器和基本的 PHP 运维能力没有的话这套源码反而会成为负担。3. 部署实操PHP 环境、数据库导入与小程序端配置结构看明白了进入动手环节。这一章按「服务器环境 → 后端部署 → 数据库 → 小程序端」的顺序走每步都给可抄的命令和参数说明。我一般会先在本地或测试服务器跑通再上生产避免直接在生产环境调试。3.1 服务器环境准备PHP 版本与扩展清单后端是 PHP环境准备的核心是版本和扩展对齐。常见做法是用宝塔面板或者手动装 LNMP我这里给手动装的思路面板用户对应操作即可。# 以 Ubuntu 为例安装 PHP 及常用扩展 sudo apt update sudo apt install -y php7.4 php7.4-fpm php7.4-mysql php7.4-mbstring \ php7.4-curl php7.4-gd php7.4-xml php7.4-zip php7.4-redis # 验证版本和已加载扩展 php -v php -m | grep -E mysql|mbstring|curl|gd|redis参数说明php7.4是主版本具体用 7.2 还是 7.4 要看源码composer.json里的require约束装之前先打开看一眼装错版本后面会报一堆兼容错误。php7.4-fpm是 FastCGI 进程管理器Nginx 靠它跑 PHP。扩展里mysql连数据库、mbstring处理中文、curl发 HTTP 请求连 Wi-Fi 的接口调用会用到、gd处理图片商家 logo、二维码生成、redis做缓存连接频率高时能扛住。php -m | grep这行是自检缺哪个补哪个。提示如果源码里用了 Redis 做会话或缓存php7.4-redis必须装否则登录态会丢表现为「刚连上 Wi-Fi 又提示未登录」这个坑后面还会提。3.2 后端部署与数据库导入环境好了把源码传到服务器 Web 目录配好入口指向public然后导数据库。# 假设源码解压到 /www/wwwroot/wifi-master cd /www/wwwroot/wifi-master # 安装 PHP 依赖如果源码带 composer.json composer install --no-dev --optimize-autoloader # 导入数据库先建库 mysql -u root -p -e CREATE DATABASE wifi_master DEFAULT CHARSET utf8mb4; mysql -u root -p wifi_master ./database/wifi_master.sql参数说明composer install --no-dev只装生产依赖跳过测试和调试包--optimize-autoloader生成优化的类映射加载更快。数据库导入前先确认.sql文件的实际路径不同打包方式位置不一样常见在database或sql目录下。utf8mb4字符集是必须的Wi-Fi 名称和商家名里可能有 emoji 或生僻字用utf8会截断。导完库要改数据库配置文件一般在config/database.php或.env里把 host、库名、用户名、密码换成你自己的。改完访问后端域名能出接口返回或后台登录页说明后端通了。3.3 小程序端配置appid、接口域名与 Wi-Fi 能力小程序端要改三处appid、后端接口域名、Wi-Fi 相关权限声明。// 小程序端 config 文件里通常长这样按实际字段名替换 const config { baseUrl: https://api.your-domain.com, // 换成你后端绑定的域名 appid: wx1234567890abcdef, // 换成你自己的小程序 appid wifi: { timeout: 8000, // 连接 Wi-Fi 超时单位毫秒 retry: 2 // 失败重试次数 } };参数说明baseUrl必须是 HTTPS微信小程序正式环境不允许 HTTP 请求域名还要在小程序后台的「开发设置-服务器域名」里加白名单否则请求直接被拦。appid换成你自己的用源码作者的 appid 跑不起来。timeout设 8000 是经验值太短在弱网下频繁失败太长用户等得烦retry: 2是失败重试配合超时用能明显降低「连不上」的投诉。Wi-Fi 连接能力依赖微信提供的接口需要在app.json里声明权限并且用户手机要开启定位安卓上连 Wi-Fi 需要定位权限这是系统限制不是 bug。这部分配置漏了表现就是「扫码后没反应」或「提示无权限」。4. 分销分账逻辑比例、结算与流量主模式怎么配部署通了只是第一步这套源码真正值钱的是分销分账。这一章讲清楚钱怎么流、参数在哪改、结算怎么跑。4.1 流量主分成的资金流向先把模式说清楚商家提供免费 Wi-Fi用户扫码连接不花钱平台把连接行为产生的流量主收益来自小程序流量主广告等按比例分给商家和推广员。资金流向是「平台收益池 → 商家分成 推广员分成 平台留存」。对应到代码里一般有三张关键表商家表存分成比例、推广关系表存谁推广了谁、分成流水表存每笔分账记录。分成比例通常存在商家表的commission_rate字段推广员比例在推广关系表里。改比例就是改这些字段但要注意改之前先备份分账数据改错了很难回滚这是血泪经验。-- 查看某商家的当前分成比例 SELECT id, shop_name, commission_rate, settle_cycle FROM wifi_shop WHERE id 1001; -- 调整分成比例示例从 30% 调到 35% UPDATE wifi_shop SET commission_rate 0.35 WHERE id 1001;参数说明commission_rate用小数存0.35 就是 35%别存成 35否则结算时金额会放大一百倍这是最常见的翻车点。settle_cycle是结算周期常见值daily、weekly、monthly对应每天、每周、每月跑一次结算任务。4.2 结算任务的触发与对账结算一般靠定时任务跑Linux 下用 crontab。找到源码里的结算脚本挂上定时。# 编辑定时任务 crontab -e # 每天凌晨 2 点跑结算输出日志便于排查 0 2 * * * /usr/bin/php /www/wwwroot/wifi-master/think settle:run /var/log/wifi_settle.log 21参数说明0 2 * * *是每天 2 点执行避开白天高峰。think settle:run是命令行入口具体命令名看源码可能是php think也可能是php bin/consoleSymfony 项目通常是后者。 /var/log/wifi_settle.log 21把标准输出和错误都写进日志出问题时有据可查别省这一步。对账是结算的后悔药。跑完结算拿流水表汇总金额和商家表应结金额对一遍对不上就查日志。常见对不上的原因是重复结算定时任务被触发两次或比例字段被改过但流水没重算。4.3 推广关系绑定与防作弊推广员拉商家入驻关系要绑定否则分账找不到人。绑定逻辑一般在用户首次通过推广员二维码进入时写入推广关系表。这里有个防作弊的点同一商家被多个推广员抢绑得有个规则常见做法是「首次绑定为准」后续再绑不覆盖。// 推广关系绑定的核心判断逻辑示意 public function bindRelation($shopId, $promoterId) { $exists Db::name(promotion_relation) -where(shop_id, $shopId) -find(); if ($exists) { return [code 0, msg 该商家已被绑定]; } Db::name(promotion_relation)-insert([ shop_id $shopId, promoter_id $promoterId, create_time time(), ]); return [code 1, msg 绑定成功]; }逻辑说明先查该商家有没有已存在的推广关系有就直接返回失败保证「首次绑定为准」。参数上shop_id和promoter_id是外键建表时加唯一索引能防并发重复插入。这段逻辑看着简单但少了exists判断就会出现一个商家被多人分账、平台多掏钱的情况。5. 避坑与排查部署和跑分销时最容易翻车的五件事这一章是我踩过和见过最多的坑按「现象 → 原因 → 解决」写照着排查能省不少时间。现象一小程序请求全部失败提示「不在以下 request 合法域名列表中」。原因后端域名没加进小程序后台的服务器域名白名单或者用了 HTTP 而非 HTTPS。 解决登录小程序后台开发设置里把https://api.your-domain.com加进 request 合法域名确保域名有有效 SSL 证书证书过期也会报这个。现象二用户扫码后连不上 Wi-Fi或连上又掉。原因安卓系统连 Wi-Fi 需要定位权限用户没开或者timeout设太短弱网下没连上就超时了。 解决在小程序里引导用户开启定位权限timeout调到 8000 到 10000 毫秒retry设 2 次。另外确认 Wi-Fi 名称里没有特殊字符部分机型对中文 SSID 兼容差。现象三结算金额比预期大一百倍。原因commission_rate存成了 35 而不是 0.35。 解决全表检查比例字段统一用小数存储改完重跑结算前先备份流水表。这个坑一旦上了生产多分出去的钱很难追回。现象四定时结算任务跑了两次商家收到双倍分成。原因crontab 配了重复条目或者脚本本身没做幂等。 解决crontab -l检查有没有重复行脚本里加结算状态标记已结算的周期跳过。常见做法是结算前先查该周期有没有已完成的结算记录。现象五后台登录后一会儿就掉线提示未登录。原因Redis 没装或没启动会话存不进去或者 PHP 的 session 目录权限不对。 解决确认php7.4-redis扩展已装、Redis 服务在跑检查config里的缓存配置指向的 Redis 地址和密码是否正确。权限问题就chown一下 session 目录。注意以上五个坑里比例存错和重复结算是资金相关的上线前务必在测试环境用假数据跑一遍完整结算流程确认金额对得上再切生产。6. 二次开发与验证改样式、加功能、跑通一笔真实分账部署和分账都通了之后多数人下一步是改样式或加功能。这一章给两个具体技巧再讲怎么验证整套链路真的跑通了。改样式前面提过只动diy.css和app.css。加功能的话后端业务代码在src下新增接口按现有 Controller 的写法照葫芦画瓢路由在config/routes里注册。小程序端新增页面在pages下建目录app.json的pages数组里加路径。这里有个容易忽略的点小程序端调后端接口域名白名单是全局的新增接口不用重复加但接口路径要和后端路由对上对不上就是 404。验证整套链路我的习惯是走一笔最小闭环用测试小程序扫码 → 连 Wi-Fi → 后台看连接记录有没有落库 → 手动触发一次结算 → 查分成流水表有没有生成记录 → 核对金额和比例是否一致。五步都过说明链路是通的。任何一步断了按上一章的排查思路定位。验证步骤检查位置通过标准扫码连接小程序端提示连接成功无报错连接落库连接记录表新增一条含用户 openid 的记录触发结算命令行/定时任务日志无报错任务正常结束生成流水分成流水表新增对应商家的分账记录金额核对流水表 vs 商家表金额 基数 × 比例误差为零从那以后我每次拿到这类分销源码都强制先跑一遍这笔最小闭环再谈改功能因为分账逻辑一旦带着 bug 上线后面补数据比重新部署还麻烦。希望帮到你。本文还有配套的精品资源点击获取