长短链大圣-微信H5牛牛棋牌联盟编译组件/15桶多品牌+长短链双模式/内附搭建教程

文章摘要

长短链大圣是一套微信/QQ 端的 H5 牛牛棋牌联盟平台，用 ThinkPHP 6 做站点后台、GatewayWorker 长连接做游戏服务端，最大特点是把品牌拆成"长连接"和"短链接"两种公众号接入方式，内置 15 个品牌桶、35 套前端模板。核心 PHP 全部经 swoole_loader 加密，属于编译产物：前端模板明文可换皮，游戏逻辑与后台逻辑不可深改。下面按架构、桶与玩法、后台功能、二开边界和搭建步骤逐项说清。

这套东西是什么

先说定位：它不是单款游戏，而是一整套"多品牌桶"的 H5 棋牌运营平台。玩家从微信/QQ 公众号进入 H5 页面，进大厅、开房间、玩牛牛，房间通过"复制链接"分享给好友接龙式拉人——这就是典型的房卡+俱乐部+联盟的熟人棋牌打法。

平台把品牌（业内叫"桶"）分成两类接入方式，这也是它名字里"长短链"的由来：

• 长连接桶：公众号在后台"微信对接"里配置，走持久连接模式。

• 短链接桶：公众号在 setting/database.txt 里配置，走短链分享模式，前端带"复制链接"入口，便于换域名、分散链接。

两种模式的游戏内容一样，区别只在公众号怎么接、链接怎么分发。对运营方而言，多一套短链模式主要是为了多品牌、多域名地铺量。

技术栈与整体架构

后端一目了然：ThinkPHP 6 负责站点与后台，GatewayWorker（基于 Workerman）负责长连接游戏服务，腾讯官方 PHP SDK 负责公众号对接。

游戏服务端是标准的 GatewayWorker 三进程模型，启动脚本清清楚楚摆在 YourApp 里：

• start_gateway.php：网关进程，维持玩家的长连接；

• start_businessworker.php：业务进程，跑发牌、结算、点控这些实际逻辑；

• start_register.php：注册中心，负责网关与业务进程互相发现。

各款游戏是独立的业务文件：Nn.php（牛牛，115KB）、Sss.php（十三水，321KB）、Sg.php（三公）、Zjh.php（炸金花）、Pj.php（牌九）、Eb.php/Ebcw.php（二八杠），总调度在 Events.php（615KB）里。从主程序根目录能看到 app（后台）、yy（GatewayWorker 服务端另一份）、view（多桶前端）、tencent-php（公众号 SDK）、vendor（框架）一整套齐活。

需要提醒的是：YourApp、app/controller、app/api、app/common.php 这些文件打开全是 extension_loaded('swoole_loader') or die(...) 开头加一段二进制——都被 swoole_loader 加密了，所以这套本质是编译产物，不是明文源码。

品牌桶清单

平台文档（sm.md）里维护了 15 个已配置好的品牌桶，按接入方式分三组：

这只是文档里主推的一批。实际 view 前端目录和 app/controller 控制器里各有约 35 套模板（大圣、道游、神兽、海贝、天王、葫芦娃、优优、超稳、火牛等），换皮加桶的空间比清单更大。

游戏玩法

主打是牛牛，人数档位拉得很满，另配了一批经典棋牌凑成合集。

牛牛玩法里明牌抢庄、通比开船、自由抢庄、牛牛上庄、固定庄家几种模式都有，底分、下注倍率、牌型倍数（四花牛到同花顺牛）、局数、各阶段时间、允许搓牌都能在开房面板里配。下面两张是实际的大厅和牌桌效果：

后台与运营功能

后台登录地址 /admins，默认 admin / 123456。功能覆盖了这类平台该有的运营盘面：用户列表、头像列表、机器人、用户战绩、导航、COS 配置、网站配置、修改密码。

数据库 33 张表也把运营体系交代得很完整：cmf_player 玩家、cmf_club/cmf_club_room/cmf_club_player 俱乐部、cmf_union 系列六张表撑起联盟与分红、cmf_guard 点控、cmf_shop 商城、cmf_navi 导航、cmf_cos 腾讯 COS 对象存储、cmf_bet_log/cmf_game_log/cmf_score_log 各类流水。

后台里最值得留意的是点控：用户列表每个玩家都挂着防反杀、白名单、全局控、控制设置几个开关；网站配置里则是公众号的 Appid、AppSecret、跳转地址、单厅开关、注册开关。

能不能二开

分两头看，界限很清楚：

• 前端可换皮、可加桶：view 下 35 套模板是明文 HTML/JS，改样式、换品牌、加新桶都能做；数据库结构完整，配置类改动没有障碍。

• 后端不可深改：游戏逻辑（发牌、赔率、点控算法）和站点后台逻辑全在 swoole_loader 加密的 PHP 里，只能按配置项调参，改不了核心玩法和风控算法。

一句话：拿来换皮铺量、配置运营没问题；想深度定制玩法或改风控，这套编译产物做不到，得有明文源码。

搭建步骤与耗时

环境卡在 PHP 7.3——因为加密用的是 swoole_loader73.so，版本不对直接跑不起来。教程里给的流程大致是：

1. 把 swoole_loader73.so 传到 PHP 7.3 扩展目录，php.ini 末尾加 extension = swoole_loader73.so；

2. 改 .env 和 yy/database.txt 里的数据库账号密码；

3. 站点运行目录设为 public，关闭防跨站；

4. Nginx 站点配置替换成教程里给的（含 location ~ \.php 走 php-cgi-73.sock、rewrite 伪静态）；

5. 导入 数据库 目录里的 SQL；

6. 进 yy 目录 ./start 启动游戏服务端（./stop 停）；

7. 长连接桶在后台"微信对接"配公众号，短链接桶在 setting/database.txt 配。

搭好后台 /admins、前端 /html。整套配下来，熟手一两个小时能跑通，主要时间花在 PHP 7.3 环境和 swoole_loader 扩展上，以及公众号域名对接。包里自带搭建教程与 Nginx 配置文本，照着走坑不多。

小结

长短链大圣是一套结构相当完整的 H5 牛牛棋牌联盟平台：GatewayWorker 长连接服务端 + ThinkPHP6 多桶后台 + 腾讯公众号对接，长短链双接入、15 桶起步、35 套模板，点控和联盟分红一应俱全。短板也明确——后端全加密，是编译产物而非源码，适合换皮铺量、配置运营，不适合深度改玩法。