A collection of immutable array functions for PHP that JS devs know and love.
array_some( callable $callback, array $array ) : bool
The array_some function checks if any elements in an array pass a conditional set by a callback function and returns a boolean based on whether the condition in callback is met for at least one array item.
JS Equivilant: Array.some()
-
callback - The function to execute per iteration
callback( mixed $item [, int $index ] ) : bool- item - The current iteration
- index - The current index
-
array - The array to be iterated over
Returns a boolean based on whether the condition in callback is met for at least one array item.
$nums = [13, 85, 15, 23];
$result = array_some(function ($num) {
return $num > 60;
}, $nums);
// $result: TRUEarray_every( callable $callback, array $array ) : bool
The array_every function checks if all elements in an array pass a conditional set by a callback function and returns a boolean based on whether condition in callback is met for all array items.
JS Equivilant: Array.every()
-
callback - The function to execute per iteration
callback( mixed $item [, int $index ] ) : bool- item - The current iteration
- index - The current index
-
array - The array to be iterated over
Returns a boolean based on whether condition in callback is met for all array items.
$nums = [13, 85, 15, 'John'];
$result = array_every(function ($num) {
return is_numeric($num);
}, $nums);
// $result: FALSEarray_find( callable $callback, array $array ) : mixed
The array_find function iterates through an array and returns the first item which meets the condition returned from the callback function.
JS Equivilant: Array.find()
-
callback - The function to execute per iteration
callback( mixed $item [, int $index ] ) : bool- item - The current iteration
- index - The current index
-
array - The array to be iterated over
Returns the first item which meets the condition returned from the callback function. If none of the items in the array meed the condtion the function NULL is returned
$names = ['Sam', 'Damo', 'Kate', 'Lucy'];
$result = array_find(function ($name) {
return $name === 'Lucy';
}, $names);
// $result: 'Lucy'array_sort( array $array [, callable $callback ] ) : array
The array_sort function sorts the items of a given array based on positive, neutral or negative values returned from the callback function or if a callback is not supplied the array will be sorted based on numerical or alphabetical values.
JS Equivilant: Array.sort()
- array - The array to be sorted
- callback - A function that compares two consecutive values in the array
callback( mixed $first, mixed $second ) : bool- first - The first item for comparison.
- second - The second item for comparison.
The sorted array
$nums = [1, 7, 3, 2, 8];
// Sort in descending order
$desc_nums = array_sort($nums, function ($first, $second) {
return $second - $first;
});
// $desc_nums: [ 8, 7, 3, 2, 1 ]
// Sort in ascending order
$asc_nums = array_sort($nums);
// $asc_nums: [ 1, 2, 3, 7, 8 ]array_flat( array $array [, mixed $depth = 1 ] ): array
The array_flat function creates a new array with all sub-array elements added into it recursively up to the specified depth. The predifined INF constant can be passed in to indicate infinate depth.
JS Equivilant Array.flat()
- array - The nested array to be flattened
- depth - Specifies how deep a nested array structure should be flattened. Defaults to 1.
The new array with the sub-array values concatenated into it.
$data = [ 1, 2, [ 3, 4, [ 5, 6, [ 7, 8 ] ] ] ];
$flattened_array = array_flat( $data, 2 );
// $flattened_array = [ 1, 2, 3, 4, 5, 6, [ 7, 8 ] ];array_entries( array $array ) : array
The array_entries function returns a new array containing arrays of the keys and values of the given array
JS Equivilant: Object.entries()
- array - The array whos [key => value] pairs are to be returned
An array of arrays containing the given arays [key => value] pairs
$key_value_array = [
'Maths' => 95,
'Physics' => 90,
'Chemistry' => 96,
'English' => 93,
'Computer' => 90
];
$entries = array_entries($key_value_array);
// $entries: [
// [ 'Maths', 95 ],
// [ 'Physics', 90 ],
// [ 'Chemistry', 96 ],
// [ 'English', 93 ],
// [ 'Computer', 90 ]
// ];array_from_entries( array $array ) : array
The array_from_entries function restores a new [key => value] array based on the arrays provided by the given array.
JS Equivilant: Object.fromEntries()
- array - The array whos arrays are to be restored to a string-keyed [key => value] format
A new array of keyed properties matching the given arrays items
$entries = [
['Maths', 95],
['Physics', 90],
['Chemistry', 96],
['English', 93],
['Computer', 90]
];
$key_value_array = array_from_entries($entries);
// $key_value_array: [
// "Maths" => 95,
// "Physics" => 90,
// "Chemistry" => 96,
// "English" => 93,
// "Computer" => 90
// ];MIT © amhislop