Search by

zairakai / laravel-essentials

zairakai

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

2.0.19 2026-11-19 04:20 UTC

README

Laravel Essentials

Laravel Essentials

Main Develop Coverage

GitLab Release Packagist Docs Downloads License

PHP Laravel Static Analysis Code Style

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

Documentation: laravel-essentials-cfbccf.gitlab.io (this guide, and the reference of every function, read from the source).

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 are registered by the service provider

Requirements

PHP 8.4 or higher and Laravel 12 or 13.

Install

composer require zairakai/laravel-essentials

No additional configuration is needed: the helpers are available globally after the install.

Usage

Examples of every helper and macro ```php // 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

See CONTRIBUTING.md for the workflow and the quality standards. composer install and make install-hooks set the package up.

make quality        # Pint, PHPStan and Markdownlint (with the rest of the gate)
make quality-fast   # Pint, PHPStan and Markdownlint
make quality-fix    # every automatic fix
make test           # PHPUnit
make test-ci        # PHPUnit with the coverage and the junit report (build/logs)
make bats           # the structure tests of the repository
make ci             # the whole gate: quality, tests and Bats

The configuration of each tool is in config/dev-tools/, one file per setting (PHPStan, Pint, PHPUnit, Rector, PHPInsights). The root holds only the thin .markdownlint.json and the .markdownlintignore. These files come from laravel-dev-tools: make setup-check tells which ones are late on the package (make setup-update publishes them again), and make config-check that no file sits where its tool does not read it.

Statistics

Statistics of laravel-essentials

Getting Help

License Security Policy Issues

Made with ❤️ by Zairakai