PHP has many built-in functions. However, my opinion is that PHP doesn't have some built-in functions that should be part of PHP. So I added them as helper functions in jPHP. What's next is that some built-in functions don't offer the necessary functionality in some situations. So, I added the necessary functionality in jPHP. See the examples below.
It's not possible for in_array() to check if a substring exists in the given array. Fortunately it's possible with jPHP.
With jPHP you can use jPHP::in_array_substring($mainNeedle, $mainHaystack).
The function array_search() searches by string comparison, it doesn't search by pattern matching. Fortunately it's possible with jPHP, jPHP offers jPHP::array_search_glob_pattern($pattern, $haystack) or jPHP::array_search_regex_pattern($pattern, $haystack) for this situation.
The library jPHP offers a collection of functions (static methods) that are based on existing php functions but with extended functionality.
Function list:
in_array_substring()in_array_substringArray()in_array_any()in_array_all()in_array_recursive()array_search_glob_pattern()array_search_regex_pattern()array_search_case_insensitive()array_filter_recursive()array_filter_php53_shim()is_iterable()is_multidimensional()array_depth()smart_push()substr()stripos_array()convertMinutesIntToDigitalClockFormat()convertSecondsToDaysHoursMinutesSeconds()
* in_array() checks if value exists. It checks by string comparison (case sensitive), thus 'A' not equal to 'a'.
* in_array_substring() just checks if the given substring exists in the haystack.
*
* How it works:
* in_array_substring() loops over the mainHaystack and,
* checks if the mainNeedle exists in the mainHaystack as a substring.
*
* The string comparison function used here is stripos(),
* thus case insensitive, thus 'A' equal to 'a'.
*
* Example with in_array():
* $os = array("Mac", "NT", "Irix", "Linux");
* if (in_array("Irix", $os)) {
* echo "Got Irix";
* }
*
* Example with in_array_substring():
* if (in_array_substring("ir", $os)) {
* echo "Got Irix";
* }
* in_array_substringArray() is a syntactic sugar for multiple stripos().
*
* Example:
* $mainHaystack = 'Australia';
* $substringList = array('ab','au');
* jPHP::in_array_substringArray($mainHaystack, $substringList); // boolean true
*
* How it works:
* The $substringList will be traversed. In this case ['ab', 'au'].
* Each iteration will search try to match a substring in the mainHaystack.
* Thus, the first iteration does this:
* stripos('Australia', 'ab'); // false
* Substring 'ab' doesn't exists in mainHaystack string 'Australia'.
* So it goes to the next iteration.
* The second iteration does tis:
* stripos('Australia', 'au'); // integer 0
* Substring 'au' exists in mainHaystack string 'Australia',
* so a boolean true gets returned.
*
* Instead of doing something like this:
* foreach ($array as $key => $value) {
* if (stripos($value, 'ab') !== false || stripos($value, 'au') !== false) {
* // something
* }
* }
* You can do this:
* foreach ($array as $key => $value) {
* if (jPHP::in_array_substringArray($value, array('ab','au'))) {
* // something
* }
* }
* in_array() checks if value exists. It checks only one value.
* in_array_any() checks if any of the given needles exists.
* in_array() checks if value exists. It checks only one value.
* in_array_any() checks if all of the given needles exists.
* in_array() checks if a value exists in an array. It checks only one level deep.
* in_array_recursive() checks recursively.
* array_search() searches a value in the the array, and gives the key. It checks by string comparison (case sensitive).
* array_search_glob_pattern() does the same, but it checks by globbing patterns/standard wildcards.
* array_search() searches a value in the the array, and gives the key. It checks by string comparison.
* array_search_regex_pattern() does the same, but it checks by regular expression.
* array_search() compares case-sensitive.
* array_search_case_insensitive() compares case-insentivie
* array_filter() filters an array. But not recursively.
* array_filter_recursive() filters an array recursively.
* array_filter() received optional flag parameters in PHP 5.6: ARRAY_FILTER_USE_KEY and ARRAY_FILTER_USE_BOTH.
* So these flags won't work in versions below php 5.6.
* array_filter_php53_shim() is a shim which allows the usage of flags in php 5.3.
* Note: it does not work for php 5.2 because of Callbacks.
* PHP 7 has a built-in is_iterable() function. But PHP 5 doens't have that
* by default. So, this is the is_iterable() function for PHP 5.
* Besides that the is_iterable() of PHP 7 says that stdClass is not
* iterable, but in fact an stdClass is iterable in foreach().
* is_multidimensional() checks if array is multidimensional.
* array_depth() gets the highest tree depth from array. It checks recursively.
* Adding new elements to an array can be done through the string access operator.
* For example like this:
* $arr['x'] = 42;
*
* Note that the string access operator can overwrite elements if the key is used twice or more.
* For example key 'x' will be overwritten in this scenario:
* $arr['x'] = 50;
* $arr['x'] = 60;
*
* smart_push() doesn't overwrite.
* smart_push() will keep the old value.
* jPHP::smart_push($arr, 'x', 70); // $arr['x'] = [0 => 60, 1 => 70];
* jPHP::smart_push($arr, 'x', 80); // $arr['x'] = [0 => 60, 1 => 70, 2 => 80];
* Returns part of the string that matches in both strings.
*
* substr() will return a substring by offset number.
* E.g. substr('Australia', 0, 5) will produce: 'Austr'.
*
* strstr() will return a portion of the haystack by needle
* E.g. strstr('Australia', 'alia', true) will produce: 'Austr'
*
* substrstr() is like a combination of substr() and strstr().
* substrstr() will compare two strings and return the part that matches in both strings.
* E.g. substrstr('Australia', 'Austria') will produce: 'Austr'.
* Alias of in_array_substringArray.
*
* stripos_array() is a syntactic sugar for multiple stripos().
*
* Instead of doing something like this:
* foreach ($array as $key => $value) {
* if (stripos($value, 'ab') !== false || stripos($value, 'au') !== false) {
* // something
* }
* }
* You can do this:
* foreach ($array as $key => $value) {
* if (jPHP::stripos_array($value, array('ab','au'))) {
* // something
* }
* }
* Convert the amount of minutes to a digital format, just like a digital clock.
*
* You can supply int 90, this function gives you: "1:30".
* If you supply an integer greater than 1440, then "00:00" is returned.
* Convert the amount of seconds to a human readable format
*
* You can supply int 129600, this function returns: "1 days 12:0:0".