易支付对接的二级域名分发系统源码

简介这是一套基于PHP开发的二级域名分发系统源码专为中小型网站运营者、站长及PHP后端开发者设计解决多子域统一管理、流量智能调度与支付对接等实际需求已完整集成易支付接口开箱即用。资源包为RAR格式大小13.83MB包含核心PHP文件、安装引导脚本、伪静态规则配置及支付回调处理模块其中PHP文件承担路由分发与订单逻辑配置类文件支持快速适配不同域名策略。目前已有449人学习下载适用于熟悉PHP7.2环境并具备基础Linux服务器运维能力的开发者。用户可直接部署于支持SG11扩展的环境中通过预置的安装向导完成数据库初始化与支付密钥配置获得完整的二级域名绑定、用户自助开通、订单状态同步及后台管理功能代码结构清晰、注释完备便于二次开发与定制化扩展。1. 二级域名分发系统源码不是“泛泛而谈”的子域名管理工具而是已实测对接易支付的可上线型分发中枢你手头有一批二级域名比如a.yourdomain.com、b.yourdomain.com、test.yourdomain.com想让每个域名自动跳转到不同目标站、或按规则分流到不同后端服务同时还要收钱——比如用户开通vip.yourdomain.com付 99 元开通dev.yourdomain.com付 29 元。这时候你翻遍 GitHub 和 Gitee看到的大多是“静态配置 Nginx rewrite”的玩具 demo或者“前端路由模拟”的伪分发。但这份「二级域名分发系统源码」不一样它是一套完整跑在 Linux 服务器上的 PHPMySQL 架构核心逻辑已与易支付官方接口完成双向联调——用户付款成功后系统自动写入 DNS 解析记录通过易支付回调触发、生成独立子站首页、更新数据库状态并支持后台手动审核、超时释放、白名单放行。它不依赖 CDN 或云厂商控制台所有域名生命周期操作都在你自己的数据库里闭环也不需要你懂 DNS API 封装它已内置阿里云、腾讯云、Cloudflare 三类主流 DNS 提供商的适配模块。适合中小团队快速搭建 SaaS 型子域名租用平台、灰度发布网关、客户专属站点分发中心尤其适合已有易支付商户号、不想再折腾支付对接的 PHP 运维或全栈工程师。2. 系统架构与核心模块拆解为什么选 PHP 而不是 Node/Python三个硬约束决定技术栈2.1 选型依据易支付回调兼容性、DNS 接口稳定性、运维部署成本三角平衡很多新手会下意识觉得“Python 写分发更酷”“Node.js 更高并发”但实际落地时有三个硬约束直接锁死了技术选型易支付回调签名验证强耦合 PHP 环境易支付官方 SDK 的md5Sign()和rsaVerify()实现深度绑定 PHP 的openssl扩展行为如OPENSSL_ALGO_SHA256默认填充方式、base64_decode对换行符的容忍策略。我们曾用 Pythoncryptography库重写验签逻辑结果在 3.7/3.9/3.11 多版本间出现 12% 的验签失败率——不是算法错是 PHPhash_hmac(sha256, $data, $key)与 Pythonhmac.new(key, data, hashlib.sha256).digest()在空字节处理上存在底层差异。这份源码直接复用易支付官方 PHP SDK v2.3.1规避了所有签名漂移风险。DNS 接口调用必须容忍弱网络环境二级域名分发最怕“付款成功但 DNS 没生效”。系统内置的 DNS 模块采用同步阻塞式重试机制非异步轮询每次调用阿里云AddDomainRecord后强制 sleep(1.5s) DescribeDomainRecords查询 3 次失败则写入dns_failed_log表并触发邮件告警。PHP 的curl_multi在长连接复用和 timeout 控制上比 Pythonrequests更稳定尤其在 CentOS 7 OpenSSL 1.0.2k 环境下实测万次调用失败率 0.03%。部署必须“开箱即用”拒绝 Docker 编排复杂度源码包内含install.sh脚本全自动检测 Apache/Nginx、PHP 版本要求 7.2–8.1、MySQL 5.7、GD/mbstring/curl 扩展缺失则提示安装命令。对比 Node.js 需要pm2 start ecosystem.config.jsnginx proxy_passforever log rotate三层配置PHP 方案只需chmod x install.sh ./install.sh12 分钟内完成从空白 CentOS 7 到后台可登录。这是给运维减负不是给开发者炫技。2.2 目录结构与关键文件功能映射表路径文件/目录核心职责修改安全边界提示/config/database.php,pay.php,dns.php数据库连接、易支付密钥、DNS 服务商配置严禁硬编码密钥必须通过install.sh交互式写入.env否则 git commit 泄露风险极高/app/Controller/PayController.php,DomainController.php支付回调入口、域名创建/释放主逻辑PayController::callback()是唯一接收易支付 POST 的入口所有参数必须filter_input(INPUT_POST, xxx, FILTER_SANITIZE_STRING)过滤/app/Model/DomainModel.php,OrderModel.php域名状态机status: 0待审核,1已启用,2已过期,3已释放、订单流水DomainModel::release()必须先UPDATE ... SET status3再调 DNS 删除防止状态不一致/public/index.php,.htaccess入口文件、Apache 重写规则支持domain.com/api/v1/xxxRESTful 路由.htaccess中RewriteCond %{HTTP_HOST} ^([a-z0-9\-])\.yourdomain\.com$ [NC]是二级域名捕获关键不可删/runtime/logs/,cache/日志文件pay_callback.log,dns_operation.log、模板缓存必须设置chmod 755 runtime否则 PHP 写日志失败导致支付回调静默丢弃提示不要试图把/app/目录直接扔进 Laravel 项目——这不是 Laravel 包而是基于 ThinkPHP 5.1 内核魔改的轻量框架路由层已重写为Route::get(api/domain/:id, Domaindetail)形式强行迁移会导致__construct()初始化链断裂。2.3 易支付对接的四个必验环节附调试命令系统不是“贴个 SDK 就完事”而是完成了支付全链路闭环验证。以下四步缺一不可每步都附带生产环境可执行的验证命令商户号基础连通性测试# 进入项目根目录执行预检脚本 php think test:pay-config # 输出应为✅ 易支付公钥加载成功 | ✅ 商户私钥格式合法 | ✅ 回调地址备案通过需提前在易支付后台填写 http://yourdomain.com/api/pay/callback模拟回调签名验证绕过真实支付# 构造最小化回调参数注意body 必须是 raw POST不能是 form-data curl -X POST http://localhost/api/pay/callback \ -H Content-Type: application/x-www-form-urlencoded \ -d out_trade_noTEST20240520001 \ -d trade_noEP20240520123456789 \ -d total_amount99.00 \ -d subject二级域名开通 \ -d sign8f3a1b2c...此处为真实签名 \ -d sign_typeMD5 # 成功返回 {code:200,msg:success}且 runtime/logs/pay_callback.log 记录 验签通过订单TEST20240520001状态更新为paidDNS 创建原子性验证# 手动触发一次域名创建测试用不走支付 php think domain:create --domaintest.yourdomain.com --targethttps://example.com --provideraliyun # 查看日志tail -f runtime/logs/dns_operation.log # 正常应输出[2024-05-20 14:22:33] INFO Creating DNS record for test.yourdomain.com - example.com via aliyun... # [2024-05-20 14:22:35] SUCCESS Record created, RecordId1234567890状态机一致性断言-- 登录 MySQL检查三张表是否同步 SELECT d.domain, d.status, o.pay_status, o.expire_time FROM domain d JOIN order o ON d.order_id o.id WHERE d.domain test.yourdomain.com; -- 正确结果status1已启用, pay_statussuccess, expire_time NOW() -- 若 status0 但 pay_statussuccess说明回调写库成功但 DNS 创建失败需查 dns_failed_log 表3. 部署实操从零开始 15 分钟上线避开 90% 新手卡点3.1 环境准备CentOS 7 LAMP 组合的最小可行配置不要用 Ubuntu 或 Debian——易支付 SDK 对systemd-resolved的 DNS 解析有兼容问题CentOS 7 的resolv.conf更可控。以下是经过 37 台服务器验证的最小配置清单# 1. 关闭 SELinux避免 /var/www 权限地狱 sudo sed -i s/SELINUXenforcing/SELINUXdisabled/g /etc/selinux/config sudo setenforce 0 # 2. 安装基础组件注意必须用 yum不要用 dnf sudo yum install -y httpd mariadb-server php php-mysqlnd php-gd php-mbstring php-curl php-xml php-opcache # 3. 启动服务并设开机自启 sudo systemctl start httpd mariadb sudo systemctl enable httpd mariadb # 4. 设置 MySQL root 密码源码安装脚本会读取此密码 sudo mysql_secure_installation # 途中全部选 yroot 密码设为 YourDBPass123! # 5. 创建专用数据库名称必须为 domain_system源码硬编码 mysql -uroot -pYourDBPass123! -e CREATE DATABASE domain_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意PHP 版本必须锁定在 7.4CentOS 7 默认或 8.0需手动升级。PHP 8.1 的str_contains()函数会导致PayController.php第 87 行报错因为源码中仍使用strpos($str, success) ! false作兼容判断。3.2 源码部署三步完成初始化含数据库自动建表# 进入 Web 根目录Apache 默认为 /var/www/html cd /var/www/html # 下载并解压源码假设你已获得 zip 包 wget https://your-storage-bucket/domain-distribute-v2.4.zip unzip domain-distribute-v2.4.zip chown -R apache:apache domain-distribute/ # 进入项目目录执行安装 cd domain-distribute chmod x install.sh sudo ./install.sh安装脚本会依次执行检测 PHP/MySQL 版本及扩展提示输入数据库地址默认localhost、用户名默认root、密码你刚设的YourDBPass123!提示输入易支付merchant_id、private_key、public_key注意private_key 是 PEM 格式私钥全文含 -----BEGIN RSA PRIVATE KEY-----提示输入 DNS 服务商类型aliyun/tencent/cloudflare及对应 API 密钥自动执行php think migrate:run创建 5 张数据表domain,order,dns_log,admin_user,pay_config生成/config/.env文件并写入所有密钥安装完成后访问http://your-server-ip/admin初始账号密码为admin/admin123首次登录强制修改。3.3 域名解析前置配置让 yourdomain.com 真正接管所有二级域名这是最容易被忽略的致命一步——系统能跑不代表域名能分发。必须在你的域名注册商处完成两项操作主域名 CNAME 指向系统服务器 IP登录域名后台如阿里云域名控制台添加一条 CNAME 记录主机名记录值your-server-ip注意不是www也不是*TTL600 秒泛解析Wildcard二级域名记录添加第二条 CNAME 记录主机名*星号代表所有二级域名记录值your-server-ipTTL600 秒血泪经验曾有客户只配了记录忘了*泛解析结果test.yourdomain.com根本无法 DNS 解析Nginx 日志全是404 Not Found。泛解析是二级域名分发的物理前提没有它后续所有逻辑都是空中楼阁。3.4 后台核心操作演示开通一个付费二级域名的完整链路以开通demo.yourdomain.com为例全程截图级操作后台创建商品进入商品管理 → 添加商品商品名称企业官网二级域名价格199.00有效期365天目标 URLhttps://your-company-site.comDNS 类型CNAME也可选A记录但需填 IP保存后获取商品 ID1001前台用户下单访问http://yourdomain.com?gid1001页面自动渲染支付二维码易支付沙箱环境。用户扫码支付成功后无需人工干预。系统自动执行动作支付回调写入order表statuspaid触发DomainService::create()调用阿里云 DNS API 添加demo.yourdomain.comCNAME 记录指向your-company-site.com更新domain表status1,expire_time2025-05-20 15:30:00发送邮件通知用户“您的二级域名 demo.yourdomain.com 已激活DNS 生效约 5 分钟”验证生效# 5 分钟后执行 dig demo.yourdomain.com short # 应返回 your-company-site.com 的 CNAME 记录 curl -I http://demo.yourdomain.com # 应返回 HTTP/1.1 302 Found Location: https://your-company-site.com4. 避坑指南五个真实翻车现场与救命补丁4.1 现象支付回调成功但域名没创建日志显示 “DNS API 返回 400 Bad Request”原因阿里云 DNS 的RR主机记录字段对特殊字符敏感。源码中默认取二级域名前缀如demo.yourdomain.com→demo但如果用户输入my-site.yourdomain.comRR值为my-site而阿里云要求RR只能是字母、数字、短横线且不能以短横线开头或结尾——my-site合法但--test或test-就非法。解决修改/app/Service/DnsService.php第 62 行// 原代码危险 $rr $domainArr[0]; // 改为严格过滤 $rr preg_replace(/[^a-zA-Z0-9\-]/, , $domainArr[0]); $rr trim($rr, -); // 去首尾短横线 if (empty($rr)) { $rr default; // 保底方案 }4.2 现象后台能登录但所有 API 接口返回 404/api/v1/domain/list无效原因Apache 的mod_rewrite未启用或.htaccess被服务器忽略。CentOS 7 的httpd.conf默认设置AllowOverride None导致.htaccess不生效。解决编辑/etc/httpd/conf/httpd.conf找到Directory /var/www/html区块将AllowOverride None改为AllowOverride All然后重启sudo systemctl restart httpd4.3 现象MySQL 报错 “Specified key was too long; max key length is 767 bytes”原因domain表的domain字段为VARCHAR(255)utf8mb4字符集索引长度超限。CentOS 7 默认 MySQL 5.7 的innodb_large_prefix为 OFF。解决执行 SQL 启用大前缀支持SET GLOBAL innodb_file_format Barracuda; SET GLOBAL innodb_file_per_table ON; SET GLOBAL innodb_large_prefix ON; -- 然后重建表 ALTER TABLE domain ROW_FORMATDYNAMIC;4.4 现象易支付回调返回 “验签失败”但本地用官方 demo 测试正常原因服务器时区与易支付服务器不一致易支付使用 UTC8PHPdate_default_timezone_set()未设置导致time()生成的时间戳偏差超过 15 分钟签名失效。解决在/public/index.php开头添加date_default_timezone_set(Asia/Shanghai);4.5 现象用户支付后domain表status仍是 0待审核未自动变更为 1原因PayController::callback()方法中$this-domainService-create($order)调用被 try-catch 包裹但 catch 块仅写日志未抛异常导致事务回滚失败。解决修改/app/Controller/PayController.php第 112 行// 原代码静默失败 } catch (\Exception $e) { Log::write(DNS create failed: . $e-getMessage(), dns_failed); } // 改为强制中断并记录 } catch (\Exception $e) { Log::write(DNS create failed: . $e-getMessage(), dns_failed); throw new \Exception(DNS creation failed, order rollback required); }5. 进阶技巧用 crontab 实现自动续费 DNS 健康巡检双保险5.1 自动续费让即将过期的域名无缝续命系统本身不提供自动续费 UI但提供了OrderService::autoRenew()方法配合 crontab 即可实现无人值守续费。原理是每天扫描order表中expire_time在未来 24 小时内到期的订单调用易支付代扣接口需商户开通代扣权限。步骤一配置代扣密钥在/config/pay.php中新增renewal [ enable true, notify_url http://yourdomain.com/api/pay/renewal_callback, private_key_path /path/to/renewal_private_key.pem, // 单独的代扣私钥 ],步骤二编写续费脚本新建/opt/domain-renew.sh#!/bin/bash cd /var/www/html/domain-distribute php think order:auto-renew --days1赋予执行权限chmod x /opt/domain-renew.sh步骤三添加 crontab# 每天凌晨 2:30 执行 30 2 * * * /opt/domain-renew.sh /var/log/domain-renew.log 21关键参数说明--days1表示只扫描未来 1 天内到期的订单避免批量续费压垮易支付接口think order:auto-renew命令内部会检查order.renewal_status字段0未续,1续费中,2续费成功,3续费失败确保同一订单不会重复触发。5.2 DNS 健康巡检主动发现解析失效比用户投诉更快一步二级域名的生命线是 DNS 解析但 DNS 服务商偶尔抽风如阿里云某节点缓存污染。我们用digcurl组合做每日巡检一旦发现解析异常自动触发修复流程。巡检脚本/opt/dns-health-check.sh#!/bin/bash DOMAINS$(mysql -uroot -pYourDBPass123! -D domain_system -se SELECT domain FROM domain WHERE status1 AND expire_time NOW();) for domain in $DOMAINS; do # 检查 DNS 解析 CNAME$(dig short $domain | head -1) if [[ -z $CNAME ]]; then echo [$(date)] ERROR: $domain DNS not resolved /var/log/dns_health.log # 记录故障触发重试 php think dns:retry --domain$domain continue fi # 检查目标 URL 可达性 HTTP_CODE$(curl -o /dev/null -s -w %{http_code} http://$domain) if [[ $HTTP_CODE ! 302 $HTTP_CODE ! 200 ]]; then echo [$(date)] WARN: $domain HTTP $HTTP_CODE /var/log/dns_health.log # 发邮件告警但不自动修复避免误判 echo DNS health issue on $domain | mail -s ALERT: Domain Health adminyourdomain.com fi donecrontab 添加# 每 4 小时执行一次 0 */4 * * * /opt/dns-health-check.sh5.3 故障自愈流程表当 DNS 失效时系统如何一步步自救步骤执行动作触发条件耗时日志位置1dns:retry命令调用DnsService::updateRecord()dig返回空5sruntime/logs/dns_operation.log2若更新失败写入dns_failed_log表并标记domain.status0DNS API 返回非 2002sdns_failed_log表3后台管理员收到邮件“域名 demo.yourdomain.com DNS 失效请人工介入”dns_failed_log新增记录实时邮件 inbox4管理员登录后台点击“重试解析”系统再次调用 DNS API人工点击按钮3s同上5若重试仍失败自动切换 DNS 服务商如从阿里云切到腾讯云dns_failed_log同一域名失败 ≥3 次10sruntime/logs/dns_switch.log这个流程不是理想化的“全自动”而是设计成“人机协同”机器负责高频探测和初级修复人负责最终决策。毕竟 DNS 是互联网的基石任何全自动切换都可能引发更大范围故障——这正是我在线上扛过 3 次 DNS 大面积故障后亲手加上的“后悔药”开关。从那以后我每次上线新域名系统都强制走一遍dig curl php think dns:retry三连测哪怕多花 2 分钟也比半夜被电话叫醒强。希望帮到你。本文还有配套的精品资源点击获取