Leakless

English

Português

English

Português

Appearance

LeaklessZero-State & Memory Leak Prevention

The autonomous runtime guardian and static analysis engine for persistent PHP workers (FrankenPHP & Laravel Octane).

Get Started →
Documentation
GitHub

Real Kernel RSS Tracking

Direct /proc/self/statm inspection on Linux to track actual Resident Set Size and catch native C-extension memory growth outside the Zend VM heap.

Automated Transaction Guard

Inspects active PDO connections at request termination, detects forgotten transactions, logs diagnostic warnings, and executes safe rollbacks.

Defensive State Rollback

Automatically restores default timezones, unclosed output buffers, and error reporting levels at the end of every worker cycle.

Graceful Worker Recycling

Intercepts requests when configured RSS memory ceilings or request limits are reached, ensuring active requests complete cleanly.

Static Worker Linter CLI

Command-line analyzer (vendor/bin/leakless analyze) with Termwind terminal UI to spot persistent worker anti-patterns in CI/CD pipelines.

Pest Custom Expectations

Native test assertions including expect($service)->toBeLeakless() and expect($closure)->toRunCleanly() for strict worker guarantees.

Quick Installation ​

bash
composer require themattosdev/leakless
bash
composer require --dev themattosdev/leakless-dev

Worker Protection Example ​

ini
# Zero-Config: Leakless auto-discovers and attaches to Octane lifecycle events
LEAKLESS_MAX_RSS_MB=256
LEAKLESS_MAX_REQUESTS=1000
LEAKLESS_CHECK_TRANSACTIONS=true
LEAKLESS_ROLLBACK_STATE=true
LEAKLESS_LOG_VIOLATIONS=true
php
use TheMattos\Leakless\Config;
use TheMattos\Leakless\Integrations\FrankenPhp\FrankenPhp;

$config = new Config(
    maxRssMb: 256,
    maxRequests: 1000,
    checkTransactions: true,
);

FrankenPhp::run(function () {
    // Your application request handler
    echo json_encode(['status' => 'ok', 'timestamp' => time()]);
}, $config);
php
use App\Services\OrderProcessor;

test('order processor executes without memory drift or transaction leaks', function () {
    expect(OrderProcessor::class)->toBeLeakless();

    expect(function () {
        (new OrderProcessor())->handleBatch();
    })->toRunCleanly(maxDriftMb: 5.0);
});
bash
vendor/bin/leakless analyze

Released under the MIT License.

Copyright © 2026 Jonathan Gonçalves