PHP Integration Guide

{
    "autoload": {
        "files": ["lib/UnifiedLicensing.PHP.v4.0-Complete.php"]
    }
}

UNIFIEDLICENSING_API_KEY=ul_live_YOUR_API_KEY
UNIFIEDLICENSING_PRODUCT_KEY=your-product-key

<?php

return [
    'api_key'     => env('UNIFIEDLICENSING_API_KEY'),
    'product_key' => env('UNIFIEDLICENSING_PRODUCT_KEY'),
];

UNIFIEDLICENSING_API_KEY=ul_live_YOUR_API_KEY
UNIFIEDLICENSING_PRODUCT_KEY=your-product-key

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use UnifiedLicenseManager;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        $this->app->singleton(UnifiedLicenseManager::class, function () {
            return new UnifiedLicenseManager(
                config('unifiedlicensing.api_key'),
                config('unifiedlicensing.product_key')
            );
        });
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use UnifiedLicenseManager;

class LicenseController extends Controller
{
    public function __construct(private UnifiedLicenseManager $licenses)
    {
    }

    public function activate(Request $request)
    {
        $validated = $request->validate([
            'license_key' => 'required|string|min:8',
        ]);

        $machineId = $this->machineId();

        $result = $this->licenses->activate(
            strtoupper(trim($validated['license_key'])),
            $machineId
        );

        if (! $result['valid']) {
            return back()->withErrors([
                'license_key' => $result['message'] ?? 'Activation failed.',
            ]);
        }

        // Remember the license for this installation
        setting(['license_key' => $validated['license_key']])->save();

        return redirect()->route('dashboard')
            ->with('status', "License activated — plan: {$result['plan']}");
    }

    private function machineId(): string
    {
        return hash('sha256', gethostname() . '|' . php_uname('m'));
    }
}

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use UnifiedLicenseManager;

class CheckLicense
{
    public function __construct(private UnifiedLicenseManager $licenses)
    {
    }

    public function handle(Request $request, Closure $next)
    {
        $licenseKey = setting('license_key');

        if (! $licenseKey) {
            return redirect()->route('license.activate')
                ->with('error', 'Please activate your license first.');
        }

        $machineId = hash('sha256', gethostname() . '|' . php_uname('m'));
        $result = $this->licenses->validate($licenseKey, $machineId);

        if (! $result['valid']) {
            abort(403, 'Your license is no longer valid: ' . ($result['message'] ?? 'unknown reason'));
        }

        return $next($request);
    }
}

<?php

use App\Http\Controllers\DashboardController;
use App\Http\Controllers\LicenseController;
use App\Http\Middleware\CheckLicense;

Route::get('/activate', [LicenseController::class, 'showForm'])
    ->name('license.activate');
Route::post('/activate', [LicenseController::class, 'activate'])
    ->name('license.store');

// Everything below requires a valid license
Route::middleware([CheckLicense::class])->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index'])
        ->name('dashboard');
});

<?php
/**
 * Plugin Name: My Premium Plugin
 * Description: Does amazing things, once a valid license is present.
 * Version: 1.0.0
 */

if (! defined('ABSPATH')) {
    exit; // No direct access.
}

require_once plugin_dir_path(__FILE__) . 'UnifiedLicensing.PHP.v4.0-Complete.php';

define('MPL_API_KEY', 'ul_live_YOUR_API_KEY');
define('MPL_PRODUCT_KEY', 'your-product-key');

// Stable machine identity for this WordPress install.
function mpl_machine_id()
{
    return hash('sha256', wp_salt('auth') . '|' . home_url());
}

function mpl_manager()
{
    static $manager = null;
    if (null === $manager) {
        $manager = new UnifiedLicenseManager(MPL_API_KEY, MPL_PRODUCT_KEY);
    }
    return $manager;
}

function mpl_license_key()
{
    return get_option('mpl_license_key', '');
}

// Gate your premium features behind this helper.
function mpl_is_licensed()
{
    $cached = get_transient('mpl_is_licensed');
    if (false !== $cached) {
        return (bool) $cached;
    }

    $key = mpl_license_key();
    if ('' === $key) {
        return false;
    }

    $result = mpl_manager()->validate($key, mpl_machine_id());
    $licensed = ! empty($result['valid']);

    set_transient('mpl_is_licensed', $licensed ? 1 : 0, 15 * MINUTE_IN_SECONDS);

    return $licensed;
}

<?php
declare(strict_types=1);

require_once __DIR__ . '/../../lib/UnifiedLicensing.PHP.v4.0-Complete.php';

header('Content-Type: application/json');

// Only accept POSTs from your own frontend
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    echo json_encode(['error' => 'Method not allowed']);
    exit;
}

$input = json_decode(file_get_contents('php://input'), true) ?? [];
$licenseKey = strtoupper(trim($input['license_key'] ?? ''));

if ($licenseKey === '') {
    http_response_code(400);
    echo json_encode(['error' => 'license_key is required']);
    exit;
}

$manager = new UnifiedLicenseManager('ul_live_YOUR_API_KEY', 'your-product-key');

// Identify the *customer's* browser install, not your server.
// A cookie set at first visit works well as a lightweight machine ID.
if (empty($_COOKIE['install_id'])) {
    setcookie('install_id', bin2hex(random_bytes(16)), ['httponly' => true, 'samesite' => 'Lax']);
}
$machineId = $_COOKIE['install_id'];

try {
    $result = $manager->validate($licenseKey, $machineId);
} catch (Exception $e) {
    http_response_code(503);
    echo json_encode(['error' => 'License service temporarily unavailable']);
    exit;
}

// Return ONLY what the frontend needs — never forward raw API responses.
echo json_encode([
    'licensed'      => (bool) ($result['valid'] ?? false),
    'plan'          => $result['plan'] ?? null,
    'reason'        => $result['valid'] ? null : ($result['message'] ?? 'invalid'),
]);

async function checkLicense(key) {
    const res = await fetch('/api/license-check.php', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ license_key: key })
    });
    return res.json();   // { licensed: true, plan: "pro", reason: null }
}

<?php
// Run hourly:  0 * * * * php /var/www/your-app/cron/heartbeat.php

require_once __DIR__ . '/../lib/UnifiedLicensing.PHP.v4.0-Complete.php';
require_once __DIR__ . '/../config/settings.php';   // loads $licenseKey

$manager = new UnifiedLicenseManager('ul_live_YOUR_API_KEY', 'your-product-key');
$machineId = hash('sha256', php_uname('n') . '|' . php_uname('m'));

try {
    $result = $manager->heartbeat($licenseKey, $machineId);

    if (isset($result['valid']) && ! $result['valid']) {
        // License was revoked, refunded, or expired since our last check.
        error_log("License revoked during heartbeat — locking features.");
        // Disable premium features, notify the admin, etc.
    }
} catch (Exception $e) {
    // Network hiccup — not fatal. Next hour's beat will retry.
    error_log("Heartbeat failed: " . $e->getMessage());
}

<?php

function ul_cache_path(string $key): string
{
    return sys_get_temp_dir() . '/ul_' . md5($key) . '.cache';
}

function ul_cache_get(string $key, int $maxAgeSeconds)
{
    $file = ul_cache_path($key);
    if (! is_file($file)) {
        return null;
    }
    if (time() - filemtime($file) > $maxAgeSeconds) {
        unlink($file);           // stale — pretend it's not there
        return null;
    }
    $raw = file_get_contents($file);
    return $raw === false ? null : json_decode($raw, true);
}

function ul_cache_set(string $key, array $data): void
{
    file_put_contents(ul_cache_path($key), json_encode($data), LOCK_EX);
}

function ul_cache_clear(string $key): void
{
    if (is_file(ul_cache_path($key))) {
        unlink(ul_cache_path($key));
    }
}

<?php
session_start();

require_once __DIR__ . '/lib/UnifiedLicensing.PHP.v4.0-Complete.php';

const UL_API_KEY     = 'ul_live_YOUR_API_KEY';
const UL_PRODUCT_KEY = 'your-product-key';

function machine_id(): string
{
    return hash('sha256', php_uname('n') . '|' . php_uname('m'));
}

$manager     = new UnifiedLicenseManager(UL_API_KEY, UL_PRODUCT_KEY);
$message     = '';
$messageType = 'ok';                      // 'ok' or 'err' — styles the banner
$licenseKey  = $_SESSION['ul_license'] ?? '';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $action   = $_POST['action'] ?? '';
    $inputKey = strtoupper(trim($_POST['license_key'] ?? ''));

    try {
        switch ($action) {
            case 'activate':
                $result = $manager->activate($inputKey, machine_id());
                if (! empty($result['valid'])) {
                    $_SESSION['ul_license'] = $inputKey;
                    $licenseKey = $inputKey;
                    $message = "License activated — plan: {$result['plan']}";
                } else {
                    $message = $result['message'] ?? 'Activation failed.';
                    $messageType = 'err';
                }
                break;

            case 'check':
                $keyToCheck = $licenseKey !== '' ? $licenseKey : $inputKey;
                $result = $manager->validate($keyToCheck, machine_id());
                $message = ! empty($result['valid'])
                    ? "License is {$result['status']} — plan: {$result['plan']}"
                    : ($result['message'] ?? 'License is not valid.');
                $messageType = ! empty($result['valid']) ? 'ok' : 'err';
                break;

            case 'trial':
                $result = $manager->startTrial(machine_id());
                if (! empty($result['success'])) {
                    $message = "Trial started — {$result['days_remaining']} days remaining.";
                } else {
                    $message = $result['message'] ?? 'Trial unavailable.';
                    $messageType = 'err';
                }
                break;
        }
    } catch (Exception $e) {
        $message = 'Could not reach the license server. Try again shortly.';
        $messageType = 'err';
    }
}

// Current status banner (live check — this page IS the license admin)
$status = null;
if ($licenseKey !== '') {
    try {
        $status = $manager->validate($licenseKey, machine_id());
    } catch (Exception $e) {
        $status = null;
    }
}
?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>License Management</title>
<style>
    body { font-family: system-ui, sans-serif; background: #081220; color: #EFEAE0;
           display: flex; justify-content: center; padding: 48px 20px; }
    .card { background: #14263B; border: 1px solid rgba(199,163,76,.25);
            border-radius: 12px; padding: 32px; max-width: 480px; width: 100%; }
    h1 { color: #E4C468; font-size: 1.4rem; margin-bottom: 6px; }
    .sub { color: #A9B2C3; font-size: .9rem; margin-bottom: 22px; }
    input[type=text] { width: 100%; padding: 10px 12px; border-radius: 8px;
           border: 1px solid rgba(199,163,76,.3); background: #0E1B2C;
           color: #EFEAE0; font-family: monospace; margin-bottom: 14px; }
    .row { display: flex; gap: 8px; flex-wrap: wrap; }
    button { flex: 1; padding: 10px; border-radius: 8px; cursor: pointer;
             border: 1px solid rgba(199,163,76,.4); background: transparent;
             color: #E4C468; font-weight: 600; }
    button.primary { background: #C7A34C; color: #081220; }
    .msg { margin-top: 16px; padding: 10px 14px; border-radius: 8px; font-size: .9rem; }
    .msg.ok  { background: rgba(126,201,143,.12); color: #7ec98f; }
    .msg.err { background: rgba(181,80,46,.15);  color: #e08a63; }
    .status { margin-top: 22px; padding: 14px 16px; border-radius: 8px;
              background: #0E1B2C; border: 1px solid rgba(199,163,76,.2);
              font-size: .88rem; line-height: 1.7; }
    .status b { color: #E4C468; }
</style>
</head>
<body>
<div class="card">
    <h1>🔒 License Management</h1>
    <p class="sub">Enter the license key from your purchase email.</p>

    <form method="post">
        <input type="text" name="license_key"
               value="<?php echo htmlspecialchars($licenseKey); ?>"
               placeholder="ABCD-EFGH-IJKL-MNOP" autocomplete="off">
        <div class="row">
            <button type="submit" name="action" value="activate" class="primary">Activate</button>
            <button type="submit" name="action" value="check">Check Status</button>
            <button type="submit" name="action" value="trial">Start Trial</button>
        </div>
    </form>

    <?php if ($message !== ''): ?>
        <div class="msg <?php echo $messageType; ?>">
            <?php echo htmlspecialchars($message); ?>
        </div>
    <?php endif; ?>

    <?php if (is_array($status)): ?>
        <div class="status">
            <?php if (! empty($status['valid'])): ?>
                <b>✓ Licensed</b><br>
                Plan: <b><?php echo htmlspecialchars((string) $status['plan']); ?></b><br>
                Seats: <?php echo (int) $status['quota_used']; ?> /
                <?php echo (int) $status['quota_limit']; ?><br>
                Expires:
                <?php echo htmlspecialchars((string) ($status['expires_at'] ?? 'never')); ?>
            <?php else: ?>
                <b style="color:#e08a63">✗ Not licensed</b><br>
                <?php echo htmlspecialchars((string) ($status['message'] ?? 'Unknown reason')); ?>
            <?php endif; ?>
        </div>
    <?php endif; ?>
</div>
</body>
</html>