PHPackages raise-studio/license-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. raise-studio/license-client ActiveLibrary[Authentication & Authorization](/categories/authentication) raise-studio/license-client =========================== Standardized PHP SDK for Raise Studio product license gating v1.0.6-beta.1(1mo ago)0801proprietaryPHPPHP ^8.2 Since Jul 14Pushed 1mo agoCompare [ Source](https://github.com/raise-studio/raise-license-client-sdk)[ Packagist](https://packagist.org/packages/raise-studio/license-client)[ Docs](https://www.raisestudio.dev)[ RSS](/packages/raise-studio-license-client/feed)WikiDiscussions master Synced 1w ago READMEChangelogDependencies (5)Versions (4)Used By (1) raise-license-client SDK ======================== [](#raise-license-client-sdk) > Framework-agnostic PHP SDK for Raise Studio product license gating. 概述 -- [](#概述) `raise-license-client` 是一个**框架无关**的 PHP SDK，为所有 Raise Studio 产品提供统一的授权门控接入。 无论你用的是 **Laravel**、**WordPress**、**原生 PHP** 还是其他框架——SDK 通过**接口 + 适配器**模式兼容所有平台。 ### 核心能力 [](#核心能力) - **JWT 签名验证**: 用内置公钥本地校验令牌，无需联网 - **License 激活/刷新**: 与 raise-license-server 交互的全部通信逻辑 - **离线降级**: 六级降级策略保证可用性（内存缓存 → JWT缓存 → Grace Period → 静默刷新 → 离线容错 → Free） - **功能门控**: 基于 `features[]` 数组的细粒度权限控制 - **代码完整性**: 关键文件的哈希自校验，防篡改（D4） - **框架无关**: 通过依赖注入适配任意平台 设计原则 ---- [](#设计原则) 原则说明**通用性**所有产品共用同一套 SDK，通过产品配置区分**无状态**JWT 自包含授权信息，离线也能验签**非对称签名**RS256（公钥验证，私钥仅在服务端），令牌不可伪造**对调用方透明**`isPro()` 方法名兼容，现有代码无需修改**安全优先**无自动本地豁免（D1）+ 完整性自校验（D4）+ 短 TTL + 吊销感知**框架无关**接口 + 适配器模式，不绑定任何框架架构 -- [](#架构) ``` src/ ├── License/ │ ├── Contracts/ │ │ ├── CacheInterface.php ← 缓存抽象 │ │ ├── HttpClientInterface.php ← HTTP 客户端抽象 │ │ └── HttpClientResponse.php ← HTTP 响应值对象 │ ├── JwtVerifier.php │ ├── LicenseClient.php ← 依赖接口，不依赖框架 │ ├── FeatureGate.php │ ├── IntegrityCheck.php │ └── Exceptions/ │ └── ... ├── Adapters/ │ ├── Laravel/ │ │ ├── LaravelCache.php ← Illuminate Cache 适配 │ │ └── LaravelHttp.php ← Illuminate Http 适配 │ ├── WordPress/ │ │ ├── WordPressCache.php ← Transients API 适配 │ │ └── WordPressHttp.php ← wp_remote_post 适配 │ └── Native/ │ ├── FileCache.php ← 文件系统缓存 │ └── CurlHttp.php ← cURL HTTP 客户端 └── Config/ └── license-config.php ``` 依赖 -- [](#依赖) SDK 核心**零框架依赖**，仅需 PHP 和 JWT 库： - PHP ^8.2 - firebase/php-jwt ^6.0 平台适配器为可选依赖： - Laravel: `illuminate/support` `illuminate/http` - WordPress: 内置函数（无需额外依赖） - Native: 无需额外依赖 快速开始 ---- [](#快速开始) ### Laravel 项目 [](#laravel-项目) ``` composer require raise-studio/license-client illuminate/support illuminate/http ``` ``` use RaiseStudio\License\LicenseClient; use RaiseStudio\License\FeatureGate; use RaiseStudio\License\Adapters\Laravel\LaravelCache; use RaiseStudio\License\Adapters\Laravel\LaravelHttp; // Laravel ServiceProvider 中注册 $this->app->singleton(LicenseClient::class, function () { $config = require __DIR__ . '/Config/license-config.php'; return new LicenseClient( $config['product_code'], $config['public_key_base64'], new LaravelCache(), new LaravelHttp(), $config['api_base_url'] ?? null, config('app.url'), // 站点 URL ); }); // 使用 $gate = app(FeatureGate::class); if ($gate->canUse('pipeline')) { /* Pro 功能 */ } ``` ### WordPress 插件 [](#wordpress-插件) ``` composer require raise-studio/license-client ``` ``` use RaiseStudio\License\LicenseClient; use RaiseStudio\License\FeatureGate; use RaiseStudio\License\Adapters\WordPress\WordPressCache; use RaiseStudio\License\Adapters\WordPress\WordPressHttp; $client = new LicenseClient( productCode: 'raise-import', publicKeyBase64: 'YOUR_PUBLIC_KEY_BASE64', cache: new WordPressCache(), http: new WordPressHttp(), ); $gate = new FeatureGate($client); $gate->setFreeFeatures(['basic_import', 'csv_support']); $gate->setAllProFeatures(['pipeline', 'advanced_mapping', 'queue']); if ($gate->canUse('pipeline')) { // Pro 功能 } ``` ### 原生 PHP 项目 [](#原生-php-项目) ``` composer require raise-studio/license-client ``` ``` use RaiseStudio\License\LicenseClient; use RaiseStudio\License\Adapters\Native\FileCache; use RaiseStudio\License\Adapters\Native\CurlHttp; $client = new LicenseClient( productCode: 'raise-import', publicKeyBase64: 'YOUR_PUBLIC_KEY_BASE64', cache: new FileCache(), http: new CurlHttp(), siteUrl: 'https://example.com', // 显式指定站点 URL ); ``` ### 自定义适配器 [](#自定义适配器) 如果你的项目使用其他缓存/HTTP 方案，实现对应接口即可： ``` use RaiseStudio\License\Contracts\CacheInterface; use RaiseStudio\License\Contracts\HttpClientInterface; use RaiseStudio\License\Contracts\HttpClientResponse; // 自定义 Redis 缓存 class RedisCache implements CacheInterface { /* ... */ } // 自定义 Guzzle HTTP class GuzzleHttp implements HttpClientInterface { /* ... */ } $client = new LicenseClient( productCode: 'my-product', publicKeyBase64: '...', cache: new RedisCache(), http: new GuzzleHttp(), ); ``` 配置模板 ---- [](#配置模板) ``` return [ 'product_code' => 'raise-import', 'public_key_base64' => 'YOUR_PUBLIC_KEY_BASE64', 'api_base_url' => 'https://admin.raisestudio.dev/api/v1', 'free_features' => ['basic_import', 'csv_support'], 'all_pro_features' => ['pipeline', 'advanced_mapping', 'queue'], ]; ``` 多语言 --- [](#多语言) SDK 错误消息支持多语言，默认语言为英文。切换到中文只需一行： ``` use RaiseStudio\License\Messages; // 切换到中文 Messages::setLocale('zh'); // 或注入自定义翻译 Messages::add('fr', [ 'activation.invalid_format' => 'Format de clé de licence invalide.', // ... ]); ``` 降级策略 ---- [](#降级策略) ``` D4 校验失败? → 仅 Free features JWT 有效 (6h)? → JWT payload.features[] 过期 < 24h? → Grace Period 接受 过期 > 24h + 网络可达? → 静默刷新 网络不通 + setLogger($logger); // 同步透传给 JwtVerifier $gate->setLogger($logger); // 同步透传给 IntegrityCheck ``` 开启后，每个验证步骤都会输出带级别与 `[②][④][⑤]` 降级阶段标记的日志（详见 `docs/raise-license-client-sdk.md` 4.3 节）。日志**不**含明文 License Key / JWT Token，敏感字段已脱敏。 文档 -- [](#文档) - [集成示例](docs/sdk-integration-example.md) - [Raise Import 迁移指南](docs/sdk-raise-import-migration.md) License ------- [](#license) Proprietary — Raise Studio. All rights reserved. 仅供 Raise Studio 授权产品使用，禁止再分发。 ### Health Score 37 — LowBetter than 81% of packages Maintenance90 Actively maintained with recent releases Popularity10 Limited adoption so far Community8 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 48d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/46275694?v=4)[tianby@shu.edu.cn](/maintainers/Tianby)[@tianby](https://github.com/tianby) --- Top Contributors [![raiseinfo](https://avatars.githubusercontent.com/u/22998521?v=4)](https://github.com/raiseinfo "raiseinfo (11 commits)") --- Tags jwtsdklicenseraise-studio ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/raise-studio-license-client/health.svg) ``` [![Health](https://phpackages.com/badges/raise-studio-license-client/health.svg)](https://phpackages.com/packages/raise-studio-license-client) ``` ### Alternatives [ellaisys/aws-cognito Laravel authentication with AWS Cognito, supporting web, API, SSO, MFA, WebAuthn, passkeys, and passwordless authentication. 122284.0k1](/packages/ellaisys-aws-cognito)[kinde-oss/kinde-auth-php Kinde PHP SDK for authentication 22100.1k3](/packages/kinde-oss-kinde-auth-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)