zairakai / laravel-essentials
Essential Laravel helpers and Str macros with zero duplication and practical defaults
Package info
gitlab.com/zairakai/php-packages/laravel-essentials
pkg:composer/zairakai/laravel-essentials
Requires
- php: ^8.4
- illuminate/collections: ^12.0 || ^13.0
- illuminate/support: ^12.0 || ^13.0
- laravel/framework: ^12.0 || ^13.43
- spatie/laravel-collection-macros: ^7.0 || ^8.1
Requires (Dev)
- ergebnis/composer-normalize: ^2.57.0
- orchestra/testbench: ^10.0 || ^11.3
- phpunit/phpunit: ^12.5.44
- zairakai/laravel-dev-tools: ^5.5
Suggests
- ergebnis/composer-normalize: Automated composer.json normalization
Provides
None
Conflicts
None
Replaces
None
README
Laravel Essentials
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
Getting Help
Made with ❤️ by Zairakai