Download the PHP package lemoba/mobile-monetization without Composer

Mobile Monetization for Laravel

Laravel 扩展包，用于移动端短剧/内容应用常见的后端验证能力：

• iOS Sign in with Apple 登录 token 验证
• Android Google 登录 ID token 验证
• iOS App Store / Android Google Play 内购验证
• Unity LevelPlay 激励广告 S2S 回调验签
• Firebase Cloud Messaging iOS / Android 消息推送

本包只做「可信验证、签名校验、接口封装、结果归一化、推送发送」，不创建数据表，不写数据库，不给用户加金币，不开通 VIP，不解锁视频。订单幂等、金币流水、会员权益、短剧解锁、推送 token 保存等业务逻辑全部由调用方完成。

安装

本地 path 仓库示例：

发布配置：

环境变量

配置文件会按职责发布到主项目：

路由

本包不注册任何默认路由，由调用方在主项目中自行定义路由和控制器。示例：

缓存

JWKS、公钥集合、Google Play OAuth token、App Store Server API bearer token、FCM OAuth token 都会走 Laravel Cache，并默认使用 Redis：

调用方可以改 store 使用任意 Laravel cache store，但生产环境建议 Redis。

登录验证

Apple：

Google：

返回字段包含：

调用方应该用 provider + provider_user_id 去绑定或创建自己的用户。

provider_user_id 来自 Apple / Google ID token 的 sub 字段。本包会强制校验 sub，如果 token 中没有 sub 会直接抛出异常，不会返回空的 provider_user_id。

支付验证

iOS App Store：

Android Google Play 一次性消耗商品：

Android Google Play VIP 周/月/年订阅：

统一返回对象：

关键字段：

建议调用方业务处理：

LevelPlay 激励广告

在 LevelPlay 后台配置 S2S Rewarded Video Callback URL：

本包不提供默认 HTTP 控制器，也不注册默认路由。调用方需要在主项目中自行创建回调入口，调用本包完成验签，并保存 event_id 做唯一幂等。

业务控制器示例：

本地测试如果不方便生成 LevelPlay 签名，可以传入第二个参数 true 开启 dev 模式，跳过 LEVELPLAY_SECRET 和 signature 校验：

verifyRewardCallback() 返回：

Firebase Cloud Messaging 推送

由于 Android 和 iOS 不在同一个 Firebase 后台，本包在 config/mobile-push.php 中分别配置两套 service account：

发送到单个设备 token：

发送到 Android：

发送到 topic：

data 会统一转成字符串值，符合 FCM HTTP v1 对 data payload 的要求。FCM OAuth token 会按平台和 service account 缓存在 Redis 中。

数据库说明

本包没有迁移文件，也不会调用 DB、Model 或 Schema。推荐调用方自行维护这些业务表或存储：

• 用户第三方登录绑定表
• 充值订单表
• 内购交易幂等表
• 金币钱包表
• 金币流水表
• VIP 订阅表
• LevelPlay 广告事件表
• 短剧视频解锁表
• 设备推送 token 表