README

🛠️ Helper Utils

Universal collection of PHP 8.5+ helper utilities — dates, strings, arrays, files, network, reflection, hashing, colors, validation and more.

This is a standalone library, not a Symfony bundle. It does not require any framework configuration. Helpers that depend on the current time, timezone, or other side-effects either accept those as explicit method parameters (for static helpers) or are injected via constructor (for service helpers).

🚀 Key Features

• Modern PHP: Strictly typed for PHP 8.5+.
• Zero Configuration: Works out of the box in any project.
• Framework Agnostic: Core logic is pure PHP, with optional integrations for Symfony components.
• Testable: Design focuses on mockability and explicit state management.
• Developer Experience: Consistent naming, clean API, and comprehensive documentation.

📦 Installation

composer require danilovl/helper-utils

🛠️ Included Helpers

Static Helpers

All helper classes are final with private constructors.

Service Helpers

DI-injectable, final readonly where stateless.

• ClockAwareDateHelper: Time-sensitive operations using PSR-20 Clock.
• DoctrineHelper: Doctrine ORM metadata and entity manager shortcuts.
• MemoryHelper: Real-time memory usage tracking and formatting.
• RequestHelper: Convenient wrapper for Symfony's Request objects.
• TimerHelper: Precise code execution timing and measurement.

Enums

• ByteUnit: Constants for data size units (B, KB, MB, etc.).
• ComparisonOperator: Common comparison operators for flexible logic.
• DateFormat: Standardized date and time format strings.

💡 Quick Examples

Static Helpers

use Danilovl\HelperUtils\Helper\Date\DateHelper;
use Danilovl\HelperUtils\Helper\String\StringHelper;
use Danilovl\HelperUtils\Helper\Network\IpHelper;

// Dates — explicit "now" for testability
$age  = DateHelper::calculateAge(new DateTimeImmutable('1990-04-25'));
$past = DateHelper::isPast($someDate, $now);

// Strings
$slug = StringHelper::slugify('Привет, мир!');           // "privet-mir"
$mask = StringHelper::maskEmail('john.doe@example.com'); // "j******e@example.com"

// IP Utilities
$ok   = IpHelper::isIpInRange('192.168.1.5', '192.168.1.0/24');
$anon = IpHelper::anonymize('192.168.1.123');             // "192.168.1.0"

Services (Dependency Injection)

use Danilovl\HelperUtils\Service\RequestHelper;
use Danilovl\HelperUtils\Service\ClockAwareDateHelper;

public function __construct(
    private RequestHelper $requestHelper,
    private ClockAwareDateHelper $clock,
) {}

$ip  = $this->requestHelper->getClientIp();
$now = $this->clock->now(); // Easily mockable

🧪 Quality Assurance

We maintain high testing standards to ensure reliability.

composer tests

The package currently includes 397 unit tests and 766 assertions.

Test Coverage

📜 Design Principles

• Immutability: Preference for \DateTimeImmutable.
• Explicitness: "Now"-dependent methods accept an explicit timestamp.
• Safety: Methods follow the doSomething (throws) / trySomething (returns null) pattern.
• Non-Invasive: Wraps powerful libraries (Symfony, Doctrine) rather than reinventing wheels.
• Finality: Classes are final to prevent fragile inheritance.

📄 License

The HelperUtils is open-sourced software licensed under the MIT license.