PHPackages                             devwebs01/gh-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. [Validation & Sanitization](/categories/validation)
4. /
5. devwebs01/gh-license

ActiveLibrary[Validation & Sanitization](/categories/validation)

devwebs01/gh-license
====================

Simple licensing client for Laravel applications - license validation, device fingerprinting, offline grace period, and feature flags.

v1.1.0(1mo ago)04MITPHPPHP ^8.1

Since May 19Pushed 1mo agoCompare

[ Source](https://github.com/devWebs01/Licensing-Client)[ Packagist](https://packagist.org/packages/devwebs01/gh-license)[ Docs](https://github.com/devWebs01/Licensing-Client)[ RSS](/packages/devwebs01-gh-license/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (7)Versions (4)Used By (0)

Laravel Licensing Client
========================

[](#laravel-licensing-client)

**Package:** `devwebs01/gh-license`
**Version:** 1.1.0
**Architecture:** GitHub Raw JSON Sync — no API server required.

Installation
------------

[](#installation)

```
composer require devwebs01/gh-license
```

Configuration
-------------

[](#configuration)

```
LICENSING_GITHUB_RAW=https://raw.githubusercontent.com/owner/repo/main
LICENSING_KEY=XXXX-XXXX-XXXX-XXXX
LICENSING_GRACE_DAYS=7
LICENSING_ADMIN_CONTACT=admin@company.com
LICENSING_APP_NAME=MyApp
LICENSING_CACHE_STORE=file
LICENSING_CACHE_TTL=3600
LICENSING_SYNC_INTERVAL=12
LICENSING_DEV_BYPASS=false
LICENSING_HMAC_SECRET=
```

> **Note:** The server pushes `max_devices`, `features`, and `updated_at` fields to GitHub.
> The client enforces `max_devices` locally (shows `deviceLimitReached` flag) and exposes `features` for feature flag checks.

Commands
--------

[](#commands)

```
php artisan license:activate XXXX-XXXX-XXXX-XXXX
php artisan license:status
php artisan license:sync
php artisan license:check
```

Quick Start
-----------

[](#quick-start)

1. Set `LICENSING_GITHUB_RAW` to your GitHub raw content base URL
2. Set `LICENSING_KEY` to the license key
3. Run `php artisan license:activate {key}`
4. Add `->middleware('license')` to protected routes

How It Works
------------

[](#how-it-works)

- License Monitor pushes JSON status files to GitHub (includes `max_devices`, `features`, `expires_at`, `status`)
- Client fetches from `https://raw.githubusercontent.com/.../licenses/{hash}.json`
- Status is cached locally with offline grace period and HMAC integrity check
- Server sync runs on Artisan schedule; stale cache auto-refresh on critical operations
- `license:status` displays all enriched fields; `license_info()` and `license_is_valid()` helpers available

Testing
-------

[](#testing)

```
vendor/bin/phpunit
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance88

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.1% 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 ~7 days

Total

2

Last Release

59d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/170791145?v=4)[Testing Bae](/maintainers/devWebs01)[@devWebs01](https://github.com/devWebs01)

---

Top Contributors

[![adptra01](https://avatars.githubusercontent.com/u/89628915?v=4)](https://github.com/adptra01 "adptra01 (33 commits)")[![devWebs01](https://avatars.githubusercontent.com/u/170791145?v=4)](https://github.com/devWebs01 "devWebs01 (1 commits)")

---

Tags

laravelvalidationlicenseactivationlicensingdevice-fingerprinting

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/devwebs01-gh-license/health.svg)

```
[![Health](https://phpackages.com/badges/devwebs01-gh-license/health.svg)](https://phpackages.com/packages/devwebs01-gh-license)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M1.0k](/packages/statamic-cms)[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.7M223](/packages/backpack-crud)[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[leantime/leantime

Open source project management system for non-project managers. Simple like Trello, powerful like Jira. Built with neurodiversity in mind.

10.2k4.0k](/packages/leantime-leantime)[firefly-iii/data-importer

Firefly III Data Import Tool.

8055.8k](/packages/firefly-iii-data-importer)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

293.1k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)