one23/helpers

One23 Helpers for php && laravel

v0.5.0 2025-03-03 09:11 UTC

Requires

• php: ^8.2|^8.3|^8.4
• ext-bcmath: *
• ext-intl: *
• ext-json: *
• ext-mbstring: *
• egulias/email-validator: ^4
• illuminate/contracts: ^v10|^v11|^v12
• illuminate/database: ^v10|^v11|^v12
• illuminate/support: ^v10|^v11|^v12
• nesbot/carbon: ^2.62|^3

Requires (Dev)

• fakerphp/faker: ^v1.21
• laravel/pint: ^v1.6
• nunomaduro/larastan: ^v2.6|^v3
• phpstan/phpstan: ^1.4.7|^2
• phpunit/phpunit: ^v10|^v11|^v12
• symfony/var-dumper: ^v6|^v7

Suggests

• laravel/framework: ^v10|^v11|^v12

MIT

README

Install

composer require one23/helpers

Helpers

Arr

use One23\Helpers\Arr;

Arr::randomValue(['a', 'b', 'c']); // a or b or c
Arr::randomValues(['a', 'b', 'c'], 2); // [a, b] or [b, c] or [c, a]
Arr::randomValues(['a', 'b', 'c'], 3); // shuffle array

Url

use One23\Helpers\Url;

$newObj = Url::object('http://aliexpress.ru/fsd')->clone(); // clone

Number

use One23\Helpers\Number;

Number::round(1 / 3, 2); // 0.33

Email

use One23\Helpers\Email;

Email::val('[e-mail]?subject=123'); // [e-mail]

Email::isValid('abc@abc'); // false
Email::isValid('[e-mail]') // true

Email::mask('[e-mail]'); // t**t@t**t.c*m

String

use One23\Helpers\Str;

Str::hasEntityCharters('abc &a abc'); // false
Str::hasEntityCharters('abc   abc'); // true

Str::mask('abc'); // a*b

Random

use One23\Helpers\Random;

Random::alpha(10); // abcdefghij (a-z)
Random::alpha(10, null); // aBcDeFgHiJ (a-zA-Z)
Random::alpha(10, true); // ABCDEFGHIJ (A-Z)

Random::base58(6); // 1a2b3c (without 0, O, I, l)

Random::base64(6); // 1a2b3c (a-zA-Z0-9)) 

Random::byte(6); // 1a2b3c (random bytes)

Random::hex(6); // 1a2b3c (a-f0-9)

Random::digit(6); // 123456 (0-9)

Random::alphaDigital(6); // 1a2b3c (a-z0-9)
Random::alphaDigital(6, null); // 1a2b3c (a-zA-Z0-9)
Random::alphaDigital(6, true); // 1a2b3c (A-Z0-9)

Random::digitalAlpha(6); // alias of alphaDigital

(new Random('charters'))->generate(8); // sretrahc ([charters]+)

Integer

use One23\Helpers\Integer;

Integer::val('123'); // 123
Integer::val('123.45'); // 123
Integer::val('abc'); // null

//

Integer::first(1, 2, 3, 4); // 1
Integer::first('a', 'b', 'c'); // null
Integer::first('a', 'b', 'c', 1); // 1

//

Integer::last(1, 2, 3, 4); // 4
Integer::last('a', 'b', 'c'); // null
Integer::last(1, 'a', 'b', 'c'); // 1

// get (value, default, min, max)

Integer::get(0, null, 1, 5); // null
Integer::get(1, null, 1, 5); // 1
Integer::get(6, null, 1, 5); // null
Integer::get('6', 1, 1, 5); // 1

// getOrNull - alias of `val`

Integer::getOrNull(0); // 0
Integer::getOrNull('abc'); // null

// getOrZero

Integer::getOrZero(0); // 0
Integer::getOrZero('abc'); // 0

// all

Integer::all(1, 2, 3, 4); // [1, 2, 3, 4]
Integer::all(1, 'a', 2, 'b'); // [1, 2]
Integer::all(1, 'a', 2, 'b', 3, 'c'); // [1, 2, 3]

// uniq

Integer::uniq(1, 2, 3, 4); // [1, 2, 3, 4]
Integer::uniq(1, 2, 3, 4, 1, 2, 3, 4); // [1, 2, 3, 4]  
Integer::uniq(1, 'a', 2, 'b', 3, 'c'); // [1, 2, 3]

// min

Integer::min(1, 2, 3, 4); // 1
Integer::min(3, 4, 2, 1); // 1
Integer::min(1, 'a', 2, 'b', 3, 'c'); // 1

// max

Integer::max(1, 2, 3, 4); // 4
Integer::max(3, 4, 2, 1); // 4
Integer::max(1, 'a', 2, 'b', 3, 'c'); // 3

// minMax

Integer::minMax(1, 'a', 2, 'b', 3, 'c'); // [1, 3]