Configuration Reference

Leakless is configured via the TheMattos\Leakless\Config object in vanilla PHP, or via .env / config/leakless.php in Laravel Octane.

---

1. Vanilla PHP Configuration

Instantiate the Config object with your desired options:

use TheMattos\Leakless\Config;
use TheMattos\Leakless\Leakless;

$config = new Config(
    enabled: true,             // Enable or disable Leakless
    maxRssMb: 256.0,           // Maximum Linux kernel RSS memory threshold in MB
    maxRequests: 1000,         // Maximum requests handled before worker recycling
    checkTransactions: true,   // Detect and roll back uncommitted PDO transactions
    rollbackState: true,       // Restore timezone, output buffers, and error levels
    logViolations: true,       // Emit diagnostic logs when anomalies are caught
);

$leakless = new Leakless($config);

---

2. Laravel Octane Configuration

In Laravel applications, configure settings directly in .env:

LEAKLESS_ENABLED=true
LEAKLESS_MAX_RSS_MB=256
LEAKLESS_MAX_REQUESTS=1000
LEAKLESS_CHECK_TRANSACTIONS=true
LEAKLESS_ROLLBACK_STATE=true
LEAKLESS_LOG_VIOLATIONS=true

Or publish config/leakless.php:

php artisan vendor:publish --tag="leakless-config"

---

3. Options Reference

Option	Environment Variable	Default	Description
enabled	LEAKLESS_ENABLED	true	Master switch to enable or bypass Leakless auditing.
max_rss_mb	LEAKLESS_MAX_RSS_MB	256.0	Real Linux kernel RSS threshold in MB. If breached, worker recycling is triggered.
max_requests	LEAKLESS_MAX_REQUESTS	null	Maximum request count per worker before triggering graceful recycling (null = unlimited).
check_transactions	LEAKLESS_CHECK_TRANSACTIONS	true	Automatically audits and rolls back open PDO transactions at request completion.
rollback_state	LEAKLESS_ROLLBACK_STATE	true	Restores default timezone, unclosed output buffers, and error reporting levels.
log_violations	LEAKLESS_LOG_VIOLATIONS	true	Emits diagnostic logs when uncommitted transactions or state leaks are caught.