README

Essential Laravel helpers and Str macros with zero duplication and practical defaults.

Features

• Boolean helpers — is_true(), is_false()
• Math helpers — is_even(), is_odd()
• String helpers — generate_random_string()
• Format helpers — number_format_locale()
• Filesystem helpers — sanitize_filename()
• Validation helpers — is_valid_email(), is_valid_ip(), is_valid_mac(), is_valid_base64()
• Array helpers — recursive_array_replace()
• Str macros — Str::isEmail(), Str::isIp(), Str::isMac(), Str::isBase64()
• Stringable macros — Str::of(...)->isEmail() and equivalents
• Auto-loaded — helpers and macros registered automatically via the service provider

Install

composer require zairakai/laravel-essentials

No additional configuration needed — helpers are available globally after install.

Usage

// Boolean helpers
is_true($value);                     // strict === true
is_false($value);                    // strict === false

// Math helpers
is_even(2);                          // true
is_odd(3);                           // true

// Number formatting
number_format_locale(1234.56, 2);   // '1 234,56'

// String helper
generate_random_string(10, 'ALPHA'); // e.g. 'QWERTYUIOP'

// Validation helpers
is_valid_email('alice@example.com'); // true
is_valid_ip('192.168.1.1');          // true
is_valid_mac('00:1A:2B:3C:4D:5E');   // true
is_valid_base64('dGVzdA==');         // true

// Array helper
recursive_array_replace('foo', 'bar', ['key' => 'foo value']); // ['key' => 'bar value']

// Str macros
Str::isEmail('alice@example.com');   // true
Str::isIp('192.168.1.1');            // true
Str::isMac('00:1A:2B:3C:4D:5E');     // true
Str::isBase64('dGVzdA==');           // true

Development

make quality        # pint + phpstan + rector + insights + markdownlint + shellcheck
make quality-fast   # pint + phpstan + markdownlint
make test           # phpunit / pest

Contributing

Contributions are welcome. Please read CONTRIBUTING.md for the project-specific workflow and quality standards.

Getting Help

Made with ❤️ by Zairakai