PHPackages                             obrainwave/siteagent-laravel - 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. [Utility & Helpers](/categories/utility)
4. /
5. obrainwave/siteagent-laravel

ActiveLibrary[Utility & Helpers](/categories/utility)

obrainwave/siteagent-laravel
============================

Silent enforcement SDK for remote website control.

v1.0.7(1mo ago)013MITPHPPHP ^8.2

Since Apr 19Pushed 1mo agoCompare

[ Source](https://github.com/Obrainwave/siteagent-laravel)[ Packagist](https://packagist.org/packages/obrainwave/siteagent-laravel)[ RSS](/packages/obrainwave-siteagent-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (9)Used By (0)

SiteAgent for Laravel
=====================

[](#siteagent-for-laravel)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

**SiteAgent** is a lightweight, cryptographically secure enforcement SDK for Laravel applications. It is the **Core Website Manager** to remotely manage the website status.

🚀 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require obrainwave/siteagent-laravel
```

⚙️ Configuration
----------------

[](#️-configuration)

Initialize the SDK with the built-in installation command:

```
php artisan siteagent:install
```

This command will:

1. Publish the `siteagent.php` config file.
2. Publish the customizable 503 suspension views.
3. Initialize the local `siteagent.state.json` file.

Alternatively, you can manually publish specific assets:

```
php artisan vendor:publish --tag="siteagent-config"
php artisan vendor:publish --tag="siteagent-views"
```

Then, configure your credentials in your `.env` file:

```
SITE_AGENT_API_KEY=your_public_key
SITE_AGENT_SECRET=your_signing_secret
SITE_AGENT_ENABLED=true
```

🛠 Integration
-------------

[](#-integration)

### 1. Automated Setup

[](#1-automated-setup)

Add the SiteAgent middleware by running the following command:

```
php artisan siteagent:install
```

The command will automatically detect your Laravel version and register the `EnforceSiteAgent` middleware in the global stack (`bootstrap/app.php` for Laravel 11+, or `app/Http/Kernel.php` for earlier versions).

### 2. Manual Fallback

[](#2-manual-fallback)

If you prefer manual registration, add the `EnforceSiteAgent` middleware to your global middleware stack:

#### Laravel 11+:

[](#laravel-11)

```
// bootstrap/app.php
->withMiddleware(function (Middleware $middleware) {
    $middleware->append(\ZuqoLab\SiteAgent\Http\Middleware\EnforceSiteAgent::class);
})
```

#### Laravel 10 and below:

[](#laravel-10-and-below)

```
// app/Http/Kernel.php
protected $middleware = [
    // ...
    \ZuqoLab\SiteAgent\Http\Middleware\EnforceSiteAgent::class,
];
```

### 2. Automated Enforcement

[](#2-automated-enforcement)

Once integrated, the SDK automatically registers a hidden control endpoint at: `POST /api/system/control`

When the Control Manager sends a `suspend` command, the middleware will intercept all incoming requests and serve a premium **503 Service Unavailable** page.

🔒 Security
----------

[](#-security)

All remote commands must be signed using **HMAC-SHA256**. The SDK automatically validates:

- **API Key**: Ensures the command is intended for this site.
- **Signature**: Prevents tampering with command payloads.
- **Timestamp**: Rejects requests older than 5 minutes to prevent replay attacks.

📄 License
---------

[](#-license)

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

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance90

Actively maintained with recent releases

Popularity5

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

Every ~0 days

Total

8

Last Release

50d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/40363034?v=4)[Olaiwola Akeem](/maintainers/obrainwave)[@Obrainwave](https://github.com/Obrainwave)

---

Top Contributors

[![Obrainwave](https://avatars.githubusercontent.com/u/40363034?v=4)](https://github.com/Obrainwave "Obrainwave (9 commits)")

### Embed Badge

![Health badge](/badges/obrainwave-siteagent-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/obrainwave-siteagent-laravel/health.svg)](https://phpackages.com/packages/obrainwave-siteagent-laravel)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pipeline

The Illuminate Pipeline package.

9348.3M264](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10533.5M984](/packages/illuminate-pagination)[illuminate/redis

The Illuminate Redis package.

8314.4M356](/packages/illuminate-redis)[spatie/laravel-export

Create a static site bundle from a Laravel app

670139.5k6](/packages/spatie-laravel-export)

PHPackages © 2026

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