bytic / utility

src/helpers/general.php

<?php

use Nip\Utility\Arr;

if (!function_exists('env')) {
    /**
     * Gets the value of an environment variable.
     *
     * @param  string $key
     * @param  mixed $default
     * @return mixed
     */
    function env($key, $default = null)
    {
        return \Nip\Utility\Env::get($key, $default);
    }
}

if (! function_exists('data_get')) {
    /**
     * Get an item from an array or object using "dot" notation.
     *
     * @param  mixed   $target
     * @param  string|array|int|callable  $key
     * @param  mixed   $default
     * @return mixed
     */
    function data_get($target, $key, $default = null)
    {
        if (is_null($key)) {

The condition is_null($key) is always false.

            return $target;
        }

        if (is_callable($key)) {
            return call_user_func($key, $target);

It seems like $key can also be of type integer; however, parameter $callback of call_user_func() does only seem to accept callable, maybe add an additional type check?

        }

        $key = is_array($key) ? $key : explode('.', $key);

It seems like $key can also be of type callable; however, parameter $string of explode() does only seem to accept string, maybe add an additional type check?

        while (! is_null($segment = array_shift($key))) {
            if ($segment === '*') {
                if (is_object($target) && method_exists($target, 'all')) {
                    $target = $target->all();
                } elseif (! is_array($target)) {
                    return value($default);
                }
                $result = [];
                foreach ($target as $item) {
                    $result[] = data_get($item, $key);
                }
                return in_array('*', $key) ? Arr::collapse($result) : $result;
            }
            if (Arr::accessible($target) && Arr::exists($target, $segment)) {
                $target = $target[$segment];
            } elseif (is_object($target)) {
                if (isset($target->{$segment})) {
                    $target = $target->{$segment};
                } elseif (method_exists($target, $segment)) {
                    $target = $target->{$segment}();
                }
            } else {
                return value($default);
            }
        }
        return $target;
    }
}
if (! function_exists('head')) {
    /**
     * Get the first element of an array. Useful for method chaining.
     *
     * @param  array  $array
     * @return mixed
     */
    function head($array)
    {
        return reset($array);
    }
}

if (! function_exists('last')) {
    /**
     * Get the last element from an array.
     *
     * @param  array  $array
     * @return mixed
     */
    function last($array)
    {
        return end($array);
    }
}

if (!function_exists('value')) {
    /**
     * Return the default value of the given value.
     *
     * @param mixed $value
     * @return mixed
     */
    function value($value)
    {
        return $value instanceof Closure ? $value() : $value;
    }
}