README

Laravel Installer - License Verification

This package adds license verification to Laravel Installer. It validates purchase codes via your API before allowing installation to proceed.

To learn all about it, head over to the extensive documentation.

Here's what you can do:

// Set your license API endpoint
LICENSE_API_URL=https://api.yoursite.com/verify

The package automatically verifies licenses:

// User enters license key
// Package calls your API
// On success: Installation continues
// On failure: Shows error message

Your API receives the license data:

{
    "license_key": "XXXX-XXXX-XXXX-XXXX",
    "email": "user@example.com",
    "domain": "customer-site.com"
}

Return verification result:

{
    "success": true,
    "message": "License verified successfully",
    "data": {
        "license_type": "professional",
        "expires_at": "2025-12-31"
    }
}

The verified license is stored in the database after installation completes.

Installation

You can install the package via composer:

composer require olakunlevpn/laravel-installer-license

Create the licenses table migration:

php artisan make:migration create_licenses_table

Configure your license API endpoint:

LICENSE_API_URL=https://api.yoursite.com/verify
LICENSE_STEP_POSITION=2

That's it! The license verification step will appear in your installer.

You can find the full installation instructions in our documentation.

Usage

The package handles everything automatically. Users enter their license key and email, and the package:

1. Calls your API with the license data
2. Validates the response
3. Stores license in session
4. After installation, saves to licenses table

Development Mode

Skip verification during development:

LICENSE_SKIP_VERIFICATION=true

Never enable in production.

Customization

Publish the configuration file:

php artisan vendor:publish --tag=laravel-installer-license-config

Publish views to customize the UI:

php artisan vendor:publish --tag=laravel-installer-license-views

Publish translations:

php artisan vendor:publish --tag=laravel-installer-license-translations

Learn more about customization in the documentation.

Changelog

Please see the main CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.