PHPackages westel/laravel-license - 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. [Payment Processing](/categories/payments) 4. / 5. westel/laravel-license ActiveLibrary[Payment Processing](/categories/payments) westel/laravel-license ====================== A comprehensive Laravel package for license management and feature gating with server-client architecture v1.0.0(1mo ago)0352โ†“50%MITPHPPHP ^7.3|^8.0|^8.1|^8.2|^8.3|^8.4 Since Mar 20Pushed 1mo agoCompare [ Source](https://github.com/KwaminaWhyte/laravel-license)[ Packagist](https://packagist.org/packages/westel/laravel-license)[ RSS](/packages/westel-laravel-license/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (6)Versions (2)Used By (0) Westel Laravel License ====================== [](#westel-laravel-license) A comprehensive Laravel package for license management and feature gating with server-client architecture, hardware fingerprinting, and offline validation. Features -------- [](#features) - **Dual Mode**: Works as both license server and client - **Hardware Fingerprinting**: Secure device binding - **Offline Validation**: JWT-based validation for up to 30 days offline - **Feature Gating**: Control feature access per license - **Grace Periods**: Configurable grace periods for expired licenses - **Multi-Product Support**: Manage licenses for multiple SaaS products - **RESTful API**: Complete API for external integrations - **Middleware**: Easy route and feature protection - **Comprehensive Logging**: Track all validation attempts - **๐ŸŽจ UI Components** (Optional): Pre-built React/Inertia.js interface for license management - **๐Ÿ” Encrypted Storage**: Database-backed license configuration with encryption Installation ------------ [](#installation) Install the package via composer: ``` composer require westel/laravel-license ``` Publish the configuration file: ``` php artisan vendor:publish --tag=license-config ``` Publish and run migrations (Server Mode only): ``` php artisan vendor:publish --tag=license-migrations php artisan migrate ``` Optional: UI-Based License Management ------------------------------------- [](#optional-ui-based-license-management) **NEW!** The package now includes optional UI components for managing license settings through a web interface instead of `.env` files. See [UI-INSTALLATION.md](UI-INSTALLATION.md) for detailed setup instructions. **Quick setup:** ``` # Publish UI assets (React/Inertia.js) php artisan vendor:publish --tag=license-ui-react php artisan vendor:publish --tag=license-controllers php artisan vendor:publish --tag=license-config-migration php artisan vendor:publish --tag=license-config-model # Run migration php artisan migrate # Build frontend npm run build ``` Features: - ๐Ÿ” Encrypted license key storage - ๐Ÿงช Connection testing - ๐ŸŽจ Beautiful React/Inertia UI - ๐Ÿ”„ Live configuration updates - โœ… Admin-only access Configuration ------------- [](#configuration) Configure the package in `config/license.php`: ### Server Mode [](#server-mode) ``` return [ 'mode' => 'server', // or 'client' // Server-specific settings 'jwt_secret' => env('LICENSE_JWT_SECRET', env('APP_KEY')), 'grace_period_days' => 7, 'offline_validation_days' => 30, 'default_activation_limit' => 5, ]; ``` ### Client Mode [](#client-mode) ``` return [ 'mode' => 'client', // Client-specific settings 'server_url' => env('LICENSE_SERVER_URL', 'https://license.yourdomain.com'), 'license_key' => env('LICENSE_KEY'), 'product_id' => env('LICENSE_PRODUCT_ID'), 'cache_ttl' => 86400, // 24 hours 'offline_mode' => true, ]; ``` Usage ----- [](#usage) ### Server Mode [](#server-mode-1) #### 1. Create Products and Licenses [](#1-create-products-and-licenses) ``` use Westel\License\Models\Product; use Westel\License\Models\License; // Create a product $product = Product::create([ 'name' => 'My SaaS Product', 'version' => '1.0.0', 'features' => ['feature1', 'feature2', 'feature3'], 'default_activation_limit' => 5, 'grace_period_days' => 7, 'offline_validation_days' => 30, ]); // Generate a license $license = License::create([ 'user_id' => $user->id, 'product_id' => $product->id, 'license_key' => License::generateLicenseKey(), 'status' => 'active', 'expires_at' => now()->addYear(), 'activation_limit' => 5, ]); ``` #### 2. API Endpoints [](#2-api-endpoints) The package automatically registers these API endpoints: ``` POST /api/license/validate - Validate license and get offline token POST /api/license/activate - Activate license on new device POST /api/license/deactivate - Deactivate device POST /api/license/heartbeat - Quick validation check GET /api/license/status - Get license status GET /api/license/features - Get available features POST /api/license/validate-feature - Validate feature access GET /api/license/tiers - Get available products/tiers ``` ### Client Mode [](#client-mode-1) #### 1. Initialize License Client [](#1-initialize-license-client) ``` use Westel\License\Facades\License; // Validate license (uses cache if available) $result = License::validate(); if ($result['valid']) { // License is valid $features = $result['features']; } else { // Handle invalid license return redirect()->route('license.invalid'); } ``` #### 2. Check Features [](#2-check-features) ``` use Westel\License\Facades\License; if (License::hasFeature('advanced_reports')) { // Feature is available } // Check feature with limits if (License::canUseFeature('api_calls', $currentUsage)) { // Feature is within limits } ``` #### 3. Middleware Protection [](#3-middleware-protection) Protect routes: ``` // In routes/web.php Route::middleware(['license.valid'])->group(function () { Route::get('/dashboard', [DashboardController::class, 'index']); }); // Protect specific features Route::middleware(['license.feature:advanced_reports'])->group(function () { Route::get('/reports', [ReportController::class, 'index']); }); ``` #### 4. Blade Directives [](#4-blade-directives) ``` @license('feature_key') Advanced Feature @endlicense @licenseValid Your license is active until {{ $licenseExpiry }} @endlicenseValid ``` #### 5. Hardware Fingerprinting [](#5-hardware-fingerprinting) ``` use Westel\License\Services\HardwareFingerprintService; $fingerprint = app(HardwareFingerprintService::class)->generate(); ``` #### 6. Offline Mode [](#6-offline-mode) The package automatically handles offline validation: ``` // First validation (online) stores JWT token License::validate(); // Subsequent validations use cached token // Valid for configured offline_validation_days License::validate(); // Uses offline token if server unreachable ``` Advanced Usage -------------- [](#advanced-usage) ### Custom Feature Validation [](#custom-feature-validation) ``` use Westel\License\Services\LicenseService; $licenseService = app(LicenseService::class); // Validate feature with custom logic $result = $licenseService->validateFeature('custom_feature', [ 'current_usage' => 100, 'additional_data' => ['key' => 'value'] ]); if ($result['allowed']) { // Proceed with feature $remaining = $result['remaining']; } ``` ### License Events [](#license-events) Listen for license events: ``` use Westel\License\Events\LicenseValidated; use Westel\License\Events\LicenseExpired; use Westel\License\Events\LicenseActivated; // In EventServiceProvider protected $listen = [ LicenseValidated::class => [ SendLicenseValidatedNotification::class, ], LicenseExpired::class => [ NotifyLicenseExpired::class, ], ]; ``` ### Grace Period Handling [](#grace-period-handling) ``` $license = License::find($licenseId); if ($license->isExpired() && $license->isInGracePeriod()) { // Show warning to user $daysRemaining = $license->getGracePeriodDaysRemaining(); flash("Your license expired. {$daysRemaining} days remaining in grace period."); } ``` API Reference ------------- [](#api-reference) ### Client SDK Methods [](#client-sdk-methods) ``` // Validation License::validate(): array License::isValid(): bool License::getStatus(): string // Features License::hasFeature(string $featureKey): bool License::canUseFeature(string $featureKey, ?int $currentUsage = null): bool License::getFeatures(): array License::getFeatureConfig(string $featureKey): ?array // Information License::getLicenseInfo(): array License::getExpiryDate(): ?Carbon License::getDaysUntilExpiry(): ?int // Actions License::activate(string $hardwareFingerprint): array License::deactivate(): array License::refresh(): array ``` ### Server API Endpoints [](#server-api-endpoints) #### POST /api/license/validate [](#post-apilicensevalidate) **Request:** ``` { "license_key": "XXXX-XXXX-XXXX-XXXX", "hardware_fingerprint": "abc123...", "product_id": "uuid", "system_info": {} } ``` **Response:** ``` { "valid": true, "status": "active", "license": { "license_key": "XXXX-XXXX-XXXX-XXXX", "expires_at": "2025-12-31T23:59:59Z", "features": ["feature1", "feature2"] }, "offline_token": "eyJ0eXAiOiJKV1QiLCJhbGc...", "next_validation": "2025-01-13T12:00:00Z" } ``` Testing ------- [](#testing) Run the package tests: ``` composer test ``` Security -------- [](#security) - Hardware fingerprints are hashed using SHA-256 - JWT tokens are signed with HS256 (or RS256 for production) - All API requests support CORS configuration - Validation attempts are logged for audit trails Migration from Existing System ------------------------------ [](#migration-from-existing-system) If you have an existing license system: 1. Backup your database 2. Install the package 3. Run migrations 4. Map your existing data to package models 5. Update API endpoints to use package routes 6. Test thoroughly before deploying Troubleshooting --------------- [](#troubleshooting) ### License validation fails in offline mode [](#license-validation-fails-in-offline-mode) Check that: - JWT secret is correctly configured - Offline token was generated during last online validation - Token has not expired (check `offline_validation_days`) ### Hardware fingerprint mismatch [](#hardware-fingerprint-mismatch) - Ensure consistent fingerprint generation - Check tolerance settings in config - Review system info being sent ### Feature gating not working [](#feature-gating-not-working) - Verify feature keys match exactly - Check license is active and not expired - Ensure features are assigned to product/plan License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. Support ------- [](#support) For support, email or open an issue on GitHub. Credits ------- [](#credits) - [Westel Team](https://github.com/westel) - [All Contributors](../../contributors) ### Health Score 43 โ€” FairBetter than 91% of packages Maintenance89 Actively maintained with recent releases Popularity16 Limited adoption so far Community6 Small or concentrated contributor base Maturity51 Maturing project, gaining track record 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 Unknown Total 1 Last Release 54d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3722454af70778cb640813c986ad52c34f21fbff8c60ed787fe0ae743ddff0ef?d=identicon)[KwaminaWhyte](/maintainers/KwaminaWhyte) --- Top Contributors [![KwaminaWhyte](https://avatars.githubusercontent.com/u/34985127?v=4)](https://github.com/KwaminaWhyte "KwaminaWhyte (16 commits)") --- Tags laravelvalidationlicensesubscriptionsaaslicensingfeature-gatingoffline-validation ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/westel-laravel-license/health.svg) ``` [![Health](https://phpackages.com/badges/westel-laravel-license/health.svg)](https://phpackages.com/packages/westel-laravel-license) ``` PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)