Values is a library to wrap PHP's primitive types into clean, immutable and more user-friendly objects.
It works on PHP >=8.0. This library is available on Composer/Packagist as gowork/values. To install it execute:
composer require gowork/values ^0.6or manually update your composer.json with:
{
(...)
"require": {
"gowork/values": "^0.6"
}
(...)
}and run composer install or composer update afterwards. If you are not using Composer, download sources from GitHub and load them as required. However, using Composer is highly recommended.
Currently available implementations are:
Object equivalent of PHP native indexed array. It contains implementation of most array_* functions as object method.
Example:
<?php
use GW\Value\Wrap;
$arrayValue = Wrap::array(['a', 'b', 'c', 'a', 'd', 'f'])
->map(function (string $value): string {
return strtoupper($value)
})
->map('strtolower')
->filter(function (string $value): bool {
return $value !== 'd';
})
->sort(function (string $a, string $b): int {
return $a <=> $b;
})
->shuffle()
->reverse()
->unique()
->diff(Wrap::array(['d', 'f']))
->intersect(Wrap::array(['a', 'b', 'c']))
->join(Wrap::array(['g', 'h', 'i']))
->unshift('j')
->shift($j)
->push('l')
->pop($l)
->slice(0, 6)
->each(function (string $value): void {
echo $value;
});
$count = $arrayValue->count();
$reduced = $arrayValue->reduce(
function (string $reduced, string $value): string {
return $reduced . $value;
},
''
);
$stringValue = $arrayValue->implode(', ');
if (isset($arrayValue[0])) {
$first = $arrayValue[0];
}
$first = $arrayValue->first();
foreach ($arrayValue as $item) {
echo $item;
}Object equivalent of PHP associative array. It has all the methods of ArrayValue with few minor differences and few additions.
<?php
use \GW\Value\Wrap;
$assocValue = Wrap::assocArray(['a' => 1, 'b' => 2, 'c' => 3, 'x' => 0])
->with('d', 4)
->without('a', 'b')
->withoutElement(0)
->merge(Wrap::assocArray(['e' => 5, 'f' => 6]));
$keys = $assocValue->keys();
$withMappedKeys = $assocValue->mapKeys(function (string $key): string {
return strtoupper($key);
});
$aValue = $assocValue->get('a', $default = 1);
$hasA = $assocValue->has('a');
$associativeArray = $assocValue->toAssocArray();
$indexedArray = $assocValue->toArray();Object equivalent of PHP primitive string. It contains implementation of most str*/mb_str* functions as object method.
<?php
use GW\Value\Wrap;
$stringValue = Wrap::string('just example string')
->trim()
->trimRight()
->trimLeft()
->lower()
->upper()
->lowerFirst()
->upperFirst()
->upperWords()
->padLeft(50, '-')
->padRight(100, '-')
->padBoth(200, '-')
->replace('no', 'yes')
->replacePattern('/\s/', '-')
->replacePatternCallback('/[\-]+/', function (array $match): string {
return '-';
})
->truncate(140)
->substring(0, 100)
->stripTags();
$hasExample = $stringValue->contains('example');
$firstA = $stringValue->position('a');
$lastA = $stringValue->positionLast('a');
$stringLength = $stringValue->length();
$primitiveString = $stringValue->toString();
$onlyLetters = $stringValue->isMatching('/^[a-z]+$/');
$stringsArray = $stringValue->explode(' ');Object wrapping array of strings. It has all methods of ArrayValue and StringValue.
Calling a method inherited from StringValue means is same as calling this method on each StringValue element contained in StringsArray.
<?php
use \GW\Value\Wrap;
use \GW\Value\StringValue;
$stringsArray = Wrap::stringsArray(['one', ' two ', '<b>three</b>'])
// StringValue
->trim()
->stripTags()
->padLeft(16)
// ArrayValue
->unique()
->each(function (StringValue $value): void {
echo $value->toString();
});Object wrapping iterable.
<?php
use \GW\Value\Wrap;
$range = function (int $start, int $end) {
for ($i = $start; $i <= $end; $i++) {
yield $i;
}
};
$stringsArray = Wrap::iterable($range(0, 10))
->join(Wrap::iterable($range(400, 440000)))
->slice(10, 20)
->filter(function (int $value): bool {
return $value % 2 === 0;
})
->map(function (int $value): int {
return $value + 2;
})
->each(function (int $value): void {
echo $value . "\n";
});For full methods reference and more examples see here.
Want to contribute? Perfect! Submit an issue or Pull Request and explain what would you like to see in GW/Value.
MIT license. See LICENSE file in the main directory of this repository.