|
- <?php
-
-
- namespace yii\helpers;
-
- use Yii;
- use yii\base\Arrayable;
- use yii\base\InvalidParamException;
-
-
- class BaseArrayHelper
- {
-
-
- public static function toArray($object, $properties = [], $recursive = true)
- {
- if (is_array($object)) {
- if ($recursive) {
- foreach ($object as $key => $value) {
- if (is_array($value) || is_object($value)) {
- $object[$key] = static::toArray($value, $properties, true);
- }
- }
- }
-
- return $object;
- } elseif (is_object($object)) {
- if (!empty($properties)) {
- $className = get_class($object);
- if (!empty($properties[$className])) {
- $result = [];
- foreach ($properties[$className] as $key => $name) {
- if (is_int($key)) {
- $result[$name] = $object->$name;
- } else {
- $result[$key] = static::getValue($object, $name);
- }
- }
-
- return $recursive ? static::toArray($result, $properties) : $result;
- }
- }
- if ($object instanceof Arrayable) {
- $result = $object->toArray([], [], $recursive);
- } else {
- $result = [];
- foreach ($object as $key => $value) {
- $result[$key] = $value;
- }
- }
-
- return $recursive ? static::toArray($result, $properties) : $result;
- } else {
- return [$object];
- }
- }
-
-
-
- public static function merge($a, $b)
- {
- $args = func_get_args();
- $res = array_shift($args);
- while (!empty($args)) {
- $next = array_shift($args);
- foreach ($next as $k => $v) {
- if ($v instanceof UnsetArrayValue) {
- unset($res[$k]);
- } elseif ($v instanceof ReplaceArrayValue) {
- $res[$k] = $v->value;
- } elseif (is_int($k)) {
- if (isset($res[$k])) {
- $res[] = $v;
- } else {
- $res[$k] = $v;
- }
- } elseif (is_array($v) && isset($res[$k]) && is_array($res[$k])) {
- $res[$k] = self::merge($res[$k], $v);
- } else {
- $res[$k] = $v;
- }
- }
- }
-
- return $res;
- }
-
-
-
- public static function getValue($array, $key, $default = null)
- {
- if ($key instanceof \Closure) {
- return $key($array, $default);
- }
-
- if (is_array($key)) {
- $lastKey = array_pop($key);
- foreach ($key as $keyPart) {
- $array = static::getValue($array, $keyPart);
- }
- $key = $lastKey;
- }
-
- if (is_array($array) && (isset($array[$key]) || array_key_exists($key, $array)) ) {
- return $array[$key];
- }
-
- if (($pos = strrpos($key, '.')) !== false) {
- $array = static::getValue($array, substr($key, 0, $pos), $default);
- $key = substr($key, $pos + 1);
- }
-
- if (is_object($array)) {
-
-
- return $array->$key;
- } elseif (is_array($array)) {
- return (isset($array[$key]) || array_key_exists($key, $array)) ? $array[$key] : $default;
- } else {
- return $default;
- }
- }
-
-
-
- public static function remove(&$array, $key, $default = null)
- {
- if (is_array($array) && (isset($array[$key]) || array_key_exists($key, $array))) {
- $value = $array[$key];
- unset($array[$key]);
-
- return $value;
- }
-
- return $default;
- }
-
-
-
- public static function index($array, $key, $groups = [])
- {
- $result = [];
- $groups = (array)$groups;
-
- foreach ($array as $element) {
- $lastArray = &$result;
-
- foreach ($groups as $group) {
- $value = static::getValue($element, $group);
- if (!array_key_exists($value, $lastArray)) {
- $lastArray[$value] = [];
- }
- $lastArray = &$lastArray[$value];
- }
-
- if ($key === null) {
- if (!empty($groups)) {
- $lastArray[] = $element;
- }
- } else {
- $value = static::getValue($element, $key);
- if ($value !== null) {
- if (is_float($value)) {
- $value = (string) $value;
- }
- $lastArray[$value] = $element;
- }
- }
- unset($lastArray);
- }
-
- return $result;
- }
-
-
-
- public static function getColumn($array, $name, $keepKeys = true)
- {
- $result = [];
- if ($keepKeys) {
- foreach ($array as $k => $element) {
- $result[$k] = static::getValue($element, $name);
- }
- } else {
- foreach ($array as $element) {
- $result[] = static::getValue($element, $name);
- }
- }
-
- return $result;
- }
-
-
-
- public static function map($array, $from, $to, $group = null)
- {
- $result = [];
- foreach ($array as $element) {
- $key = static::getValue($element, $from);
- $value = static::getValue($element, $to);
- if ($group !== null) {
- $result[static::getValue($element, $group)][$key] = $value;
- } else {
- $result[$key] = $value;
- }
- }
-
- return $result;
- }
-
-
-
- public static function keyExists($key, $array, $caseSensitive = true)
- {
- if ($caseSensitive) {
-
-
- return isset($array[$key]) || array_key_exists($key, $array);
- } else {
- foreach (array_keys($array) as $k) {
- if (strcasecmp($key, $k) === 0) {
- return true;
- }
- }
-
- return false;
- }
- }
-
-
-
- public static function multisort(&$array, $key, $direction = SORT_ASC, $sortFlag = SORT_REGULAR)
- {
- $keys = is_array($key) ? $key : [$key];
- if (empty($keys) || empty($array)) {
- return;
- }
- $n = count($keys);
- if (is_scalar($direction)) {
- $direction = array_fill(0, $n, $direction);
- } elseif (count($direction) !== $n) {
- throw new InvalidParamException('The length of $direction parameter must be the same as that of $keys.');
- }
- if (is_scalar($sortFlag)) {
- $sortFlag = array_fill(0, $n, $sortFlag);
- } elseif (count($sortFlag) !== $n) {
- throw new InvalidParamException('The length of $sortFlag parameter must be the same as that of $keys.');
- }
- $args = [];
- foreach ($keys as $i => $key) {
- $flag = $sortFlag[$i];
- $args[] = static::getColumn($array, $key);
- $args[] = $direction[$i];
- $args[] = $flag;
- }
-
-
-
- $args[] = range(1, count($array));
- $args[] = SORT_ASC;
- $args[] = SORT_NUMERIC;
-
- $args[] = &$array;
- call_user_func_array('array_multisort', $args);
- }
-
-
-
- public static function htmlEncode($data, $valuesOnly = true, $charset = null)
- {
- if ($charset === null) {
- $charset = Yii::$app ? Yii::$app->charset : 'UTF-8';
- }
- $d = [];
- foreach ($data as $key => $value) {
- if (!$valuesOnly && is_string($key)) {
- $key = htmlspecialchars($key, ENT_QUOTES | ENT_SUBSTITUTE, $charset);
- }
- if (is_string($value)) {
- $d[$key] = htmlspecialchars($value, ENT_QUOTES | ENT_SUBSTITUTE, $charset);
- } elseif (is_array($value)) {
- $d[$key] = static::htmlEncode($value, $valuesOnly, $charset);
- } else {
- $d[$key] = $value;
- }
- }
-
- return $d;
- }
-
-
-
- public static function htmlDecode($data, $valuesOnly = true)
- {
- $d = [];
- foreach ($data as $key => $value) {
- if (!$valuesOnly && is_string($key)) {
- $key = htmlspecialchars_decode($key, ENT_QUOTES);
- }
- if (is_string($value)) {
- $d[$key] = htmlspecialchars_decode($value, ENT_QUOTES);
- } elseif (is_array($value)) {
- $d[$key] = static::htmlDecode($value);
- } else {
- $d[$key] = $value;
- }
- }
-
- return $d;
- }
-
-
-
- public static function isAssociative($array, $allStrings = true)
- {
- if (!is_array($array) || empty($array)) {
- return false;
- }
-
- if ($allStrings) {
- foreach ($array as $key => $value) {
- if (!is_string($key)) {
- return false;
- }
- }
- return true;
- } else {
- foreach ($array as $key => $value) {
- if (is_string($key)) {
- return true;
- }
- }
- return false;
- }
- }
-
-
-
- public static function isIndexed($array, $consecutive = false)
- {
- if (!is_array($array)) {
- return false;
- }
-
- if (empty($array)) {
- return true;
- }
-
- if ($consecutive) {
- return array_keys($array) === range(0, count($array) - 1);
- } else {
- foreach ($array as $key => $value) {
- if (!is_int($key)) {
- return false;
- }
- }
- return true;
- }
- }
-
-
-
- public static function isIn($needle, $haystack, $strict = false)
- {
- if ($haystack instanceof \Traversable) {
- foreach ($haystack as $value) {
- if ($needle == $value && (!$strict || $needle === $value)) {
- return true;
- }
- }
- } elseif (is_array($haystack)) {
- return in_array($needle, $haystack, $strict);
- } else {
- throw new InvalidParamException('Argument $haystack must be an array or implement Traversable');
- }
-
- return false;
- }
-
-
-
- public static function isTraversable($var)
- {
- return is_array($var) || $var instanceof \Traversable;
- }
-
-
-
- public static function isSubset($needles, $haystack, $strict = false)
- {
- if (is_array($needles) || $needles instanceof \Traversable) {
- foreach ($needles as $needle) {
- if (!static::isIn($needle, $haystack, $strict)) {
- return false;
- }
- }
- return true;
- } else {
- throw new InvalidParamException('Argument $needles must be an array or implement Traversable');
- }
- }
-
-
-
- public static function filter($array, $filters)
- {
- $result = [];
- $forbiddenVars = [];
-
- foreach ($filters as $var) {
- $keys = explode('.', $var);
- $globalKey = $keys[0];
- $localKey = isset($keys[1]) ? $keys[1] : null;
-
- if ($globalKey[0] === '!') {
- $forbiddenVars[] = [
- substr($globalKey, 1),
- $localKey,
- ];
- continue;
- }
-
- if (empty($array[$globalKey])) {
- continue;
- }
- if ($localKey === null) {
- $result[$globalKey] = $array[$globalKey];
- continue;
- }
- if (!isset($array[$globalKey][$localKey])) {
- continue;
- }
- if (!array_key_exists($globalKey, $result)) {
- $result[$globalKey] = [];
- }
- $result[$globalKey][$localKey] = $array[$globalKey][$localKey];
- }
-
- foreach ($forbiddenVars as $var) {
- list($globalKey, $localKey) = $var;
- if (array_key_exists($globalKey, $result)) {
- unset($result[$globalKey][$localKey]);
- }
- }
-
- return $result;
- }
- }
|