extalion / php-strict-array
Generator for generic arrays (vector, map)
Requires
- php: ^7.2
- extalion/php-enum: ^0.1
- symfony/console: ^5.0
- twig/twig: ^2.12
Requires (Dev)
- phpunit/phpunit: ^8.4
This package is auto-updated.
Last update: 2024-04-13 01:54:28 UTC
README
According to this article which shows how to create strictly typed arrays and collections in Php7, php-strict-array was born.
There is some discusion about generic in Php but who knows when it comes to us.
It is not exacly what you know from Java or C++ where generic looks like
array<bool>()
or array<string, \Foo\User>()
.
Here strict arrays looks like array_int_
, array_bool_
and
array_string_and_float_
so I hope when they come to nativ Php all what you
need to do will be:
- Replace all
new array_User
,new array_string_and_array_object__
toarray<User>
,array<string, array<object>>
.
Now you do not have to validate array from user inside your packages:
function foo(array $users) { foreach ($users as $user) { if (!$user instanceof User) { thorw new \InvalidArgumentException(); } } ... }
Your code can be much simpler:
function foo(array_User_ $users) { ... }
Install
composer require eXtalion/php-strict-array
Base strict arrays
Some base arrays are generated:
array_array_
,array_bool_
,array_callable_
,array_float_
,array_int_
,array_iterable_
,array_object_
,array_string_
,array_string_and_array_
,array_string_and_bool_
,array_string_and_callable_
,array_string_and_float_
,array_string_and_int_
,array_string_and_iterable_
,array_string_and_object_
,array_string_and_string_
.
Create new strict array
Run:
vendor/bin/php-sa [path/to/arrays-dir]
and answer to fee questions. Without path/to/arrays-dir code will be display to STDOUT.
It's "normal" array
There are some array functions which works with strict arrays:
sarray_filter
,sarray_key_exists
,sarray_keys
,sarray_search
,sarray_values
.