helpers.php 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. <?php
  2. use Illuminate\Support\Arr;
  3. use Illuminate\Support\Collection;
  4. if (! function_exists('collect')) {
  5. /**
  6. * Create a collection from the given value.
  7. *
  8. * @template TKey of array-key
  9. * @template TValue
  10. *
  11. * @param \Illuminate\Contracts\Support\Arrayable<TKey, TValue>|iterable<TKey, TValue>|null $value
  12. * @return \Illuminate\Support\Collection<TKey, TValue>
  13. */
  14. function collect($value = [])
  15. {
  16. return new Collection($value);
  17. }
  18. }
  19. if (! function_exists('data_fill')) {
  20. /**
  21. * Fill in data where it's missing.
  22. *
  23. * @param mixed $target
  24. * @param string|array $key
  25. * @param mixed $value
  26. * @return mixed
  27. */
  28. function data_fill(&$target, $key, $value)
  29. {
  30. return data_set($target, $key, $value, false);
  31. }
  32. }
  33. if (! function_exists('data_get')) {
  34. /**
  35. * Get an item from an array or object using "dot" notation.
  36. *
  37. * @param mixed $target
  38. * @param string|array|int|null $key
  39. * @param mixed $default
  40. * @return mixed
  41. */
  42. function data_get($target, $key, $default = null)
  43. {
  44. if (is_null($key)) {
  45. return $target;
  46. }
  47. $key = is_array($key) ? $key : explode('.', $key);
  48. foreach ($key as $i => $segment) {
  49. unset($key[$i]);
  50. if (is_null($segment)) {
  51. return $target;
  52. }
  53. if ($segment === '*') {
  54. if ($target instanceof Collection) {
  55. $target = $target->all();
  56. } elseif (! is_iterable($target)) {
  57. return value($default);
  58. }
  59. $result = [];
  60. foreach ($target as $item) {
  61. $result[] = data_get($item, $key);
  62. }
  63. return in_array('*', $key) ? Arr::collapse($result) : $result;
  64. }
  65. if (Arr::accessible($target) && Arr::exists($target, $segment)) {
  66. $target = $target[$segment];
  67. } elseif (is_object($target) && isset($target->{$segment})) {
  68. $target = $target->{$segment};
  69. } else {
  70. return value($default);
  71. }
  72. }
  73. return $target;
  74. }
  75. }
  76. if (! function_exists('data_set')) {
  77. /**
  78. * Set an item on an array or object using dot notation.
  79. *
  80. * @param mixed $target
  81. * @param string|array $key
  82. * @param mixed $value
  83. * @param bool $overwrite
  84. * @return mixed
  85. */
  86. function data_set(&$target, $key, $value, $overwrite = true)
  87. {
  88. $segments = is_array($key) ? $key : explode('.', $key);
  89. if (($segment = array_shift($segments)) === '*') {
  90. if (! Arr::accessible($target)) {
  91. $target = [];
  92. }
  93. if ($segments) {
  94. foreach ($target as &$inner) {
  95. data_set($inner, $segments, $value, $overwrite);
  96. }
  97. } elseif ($overwrite) {
  98. foreach ($target as &$inner) {
  99. $inner = $value;
  100. }
  101. }
  102. } elseif (Arr::accessible($target)) {
  103. if ($segments) {
  104. if (! Arr::exists($target, $segment)) {
  105. $target[$segment] = [];
  106. }
  107. data_set($target[$segment], $segments, $value, $overwrite);
  108. } elseif ($overwrite || ! Arr::exists($target, $segment)) {
  109. $target[$segment] = $value;
  110. }
  111. } elseif (is_object($target)) {
  112. if ($segments) {
  113. if (! isset($target->{$segment})) {
  114. $target->{$segment} = [];
  115. }
  116. data_set($target->{$segment}, $segments, $value, $overwrite);
  117. } elseif ($overwrite || ! isset($target->{$segment})) {
  118. $target->{$segment} = $value;
  119. }
  120. } else {
  121. $target = [];
  122. if ($segments) {
  123. data_set($target[$segment], $segments, $value, $overwrite);
  124. } elseif ($overwrite) {
  125. $target[$segment] = $value;
  126. }
  127. }
  128. return $target;
  129. }
  130. }
  131. if (! function_exists('data_forget')) {
  132. /**
  133. * Remove / unset an item from an array or object using "dot" notation.
  134. *
  135. * @param mixed $target
  136. * @param string|array|int|null $key
  137. * @return mixed
  138. */
  139. function data_forget(&$target, $key)
  140. {
  141. $segments = is_array($key) ? $key : explode('.', $key);
  142. if (($segment = array_shift($segments)) === '*' && Arr::accessible($target)) {
  143. if ($segments) {
  144. foreach ($target as &$inner) {
  145. data_forget($inner, $segments);
  146. }
  147. }
  148. } elseif (Arr::accessible($target)) {
  149. if ($segments && Arr::exists($target, $segment)) {
  150. data_forget($target[$segment], $segments);
  151. } else {
  152. Arr::forget($target, $segment);
  153. }
  154. } elseif (is_object($target)) {
  155. if ($segments && isset($target->{$segment})) {
  156. data_forget($target->{$segment}, $segments);
  157. } elseif (isset($target->{$segment})) {
  158. unset($target->{$segment});
  159. }
  160. }
  161. return $target;
  162. }
  163. }
  164. if (! function_exists('head')) {
  165. /**
  166. * Get the first element of an array. Useful for method chaining.
  167. *
  168. * @param array $array
  169. * @return mixed
  170. */
  171. function head($array)
  172. {
  173. return reset($array);
  174. }
  175. }
  176. if (! function_exists('last')) {
  177. /**
  178. * Get the last element from an array.
  179. *
  180. * @param array $array
  181. * @return mixed
  182. */
  183. function last($array)
  184. {
  185. return end($array);
  186. }
  187. }
  188. if (! function_exists('value')) {
  189. /**
  190. * Return the default value of the given value.
  191. *
  192. * @param mixed $value
  193. * @param mixed ...$args
  194. * @return mixed
  195. */
  196. function value($value, ...$args)
  197. {
  198. return $value instanceof Closure ? $value(...$args) : $value;
  199. }
  200. }