README

A lightweight, framework-agnostic PHP library for automatically masking sensitive data in logs. Useful for privacy compliance (e.g., GDPR, PCI DSS) and secure debugging.

✅ Framework-agnostic — works with any PHP project
✅ Format-aware — supports plain text, JSON, XML
✅ Regex-based masking with override support
✅ Ships with secure defaults (emails, passwords, API keys, etc.)
✅ Configurable via external mask.php pattern file
✅ No Monolog or PSR-3 required
✅ Modern PHP 8.0+ (typed properties, constructor promotion)

🚀 Installation

Install via Composer:

composer require ksardv/php-log-sanitizer

🧩 Framework Integration

Laravel

You can use php-log-sanitizer in Laravel without any special service provider or package.

Basic usage in a custom log processor:

use Ksardv\PhpLogSanitizer\PatternRepository;
use Ksardv\PhpLogSanitizer\Sanitizers\JsonSanitizer;

$patterns = PatternRepository::fromFile(config_path('log_mask.php'));
$sanitizer = new JsonSanitizer($patterns);

Log::info($sanitizer->sanitize(json_encode($yourPayload)));

📁 Examples Directory

See the examples/ folder for real code:

text.php – raw string sanitization
json.php – structured JSON masking
xml.php – XML sanitization
add_pattern.php – how to define custom rules

ksardv / php-log-sanitizer

Maintainers

Details