array_add()
array_add
函数添加给定键值对到数组 —— 如果给定键不存在的话:
$array = array_add(['name' => 'Desk'], 'price', 100);
// ['name' => 'Desk', 'price' => 100]
array_collapse()
array_collapse
函数将多个数组合并成一个:
$array = array_collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);
// [1, 2, 3, 4, 5, 6, 7, 8, 9]
array_divide()
array_divide
函数返回两个数组,一个包含原数组的所有键,另外一个包含原数组的所有值:
list($keys, $values) = array_divide(['name' => 'Desk']);
// $keys: ['name']
// $values: ['Desk']
array_dot()
array_dot
函数使用”.”号将将多维数组转化为一维数组:
$array = ['products' => ['desk' => ['price' => 100]]];
$flattened = array_dot($array);
// ['products.desk.price' => 100]
array_except()
array_except
函数从数组中移除给定键值对:
$array = ['name' => 'Desk', 'price' => 100];
$array = array_except($array, ['price']);
// ['name' => 'Desk']
array_first()
array_first
函数返回通过测试数组的第一个元素:
$array = [100, 200, 300];
$value = array_first($array, function ($value, $key) {
return $value >= 150;
});
// 200
默认值可以作为第三个参数传递给该方法,如果没有值通过测试的话返回默认值:
$value = array_first($array, $callback, $default);
array_flatten()
array_flatten
函数将多维数组转化为一维数组:
$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']];
$array = array_flatten($array);
// ['Joe', 'PHP', 'Ruby'];
array_forget()
array_forget
函数使用”.”号从嵌套数组中移除给定键值对:
$array = ['products' => ['desk' => ['price' => 100]]];
array_forget($array, 'products.desk');
// ['products' => []]
array_get()
array_get
方法使用”.”号从嵌套数组中获取值:
$array = ['products' => ['desk' => ['price' => 100]]];
$value = array_get($array, 'products.desk.price');
// ['price' => 100]
array_get
函数还接收一个默认值,如果指定键不存在的话则返回该默认值:
$value = array_get($array, 'products.desk.discount', 0);
// 0
array_has()
array_has
函数使用“.”检查给定数据项是否在数组中存在:
$array = ['product' => ['name' => 'desk', 'price' => 100]];
$hasItem = array_has($array, 'product.name');
// true
$hasItems = array_has($array, ['product.price', 'product.discount']);
// false
array_last()
array_last
函数返回通过过滤数组的最后一个元素:
$array = [100, 200, 300, 110];
$value = array_last($array, function ($value, $key) {
return $value >= 150;
});
// 300
我们可以传递一个默认值作为第三个参数到该函数,如果没有值通过真理测试的话该默认值被返回:
$last = array_last($array, $callback, $default);
array_only()
array_only
方法只从给定数组中返回指定键值对:
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
$array = array_only($array, ['name', 'price']);
// ['name' => 'Desk', 'price' => 100]
array_pluck()
array_pluck
方法从数组中返回给定键对应的键值对列表:
$array = [
['developer' => ['id' => 1, 'name' => 'Taylor']],
['developer' => ['id' => 2, 'name' => 'Abigail']],
];
$names = array_pluck($array, 'developer.name');
// ['Taylor', 'Abigail']
你还可以指定返回结果的键:
$array = array_pluck($array, 'developer.name', 'developer.id');
// [1 => 'Taylor', 2 => 'Abigail'];
array_prepend()
array_prepend
函数将数据项推入数组开头:
$array = ['one', 'two', 'three', 'four'];
$array = array_prepend($array, 'zero');
// $array: ['zero', 'one', 'two', 'three', 'four']
如果需要的话还可以指定用于该值的键:
$array = ['price' => 100];
$array = array_prepend($array, 'Desk', 'name');
// ['name' => 'Desk', 'price' => 100]
array_pull()
array_pull
函数从数组中返回并移除键值对:
$array = ['name' => 'Desk', 'price' => 100];
$name = array_pull($array, 'name');
// $name: Desk
// $array: ['price' => 100]
我们还可以传递默认值作为第三个参数到该函数,如果指定键不存在的话返回该值:
$value = array_pull($array, $key, $default);
array_random()
array_random
函数从数组中返回随机值:
$array = [1, 2, 3, 4, 5];
$random = array_random($array);
// 4 - (retrieved randomly)
还可以指定返回的数据项数目作为可选的第二个参数,需要注意的是提供这个参数会返回一个数组,即使只返回一个数据项:
$items = array_random($array, 2);
// [2, 5] - (retrieved randomly)
array_set()
array_set
函数用于在嵌套数组中使用”.”号设置值:
$array = ['products' => ['desk' => ['price' => 100]]];
array_set($array, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 200]]]
array_sort()
array_sort
函数通过值对数组进行排序:
$array = ['Desk', 'Table', 'Chair'];
$sorted = array_sort($array);
// ['Chair', 'Desk', 'Table']
还可以通过给定闭包的结果对数组进行排序:
$array = [
['name' => 'Desk'],
['name' => 'Table'],
['name' => 'Chair'],
];
$sorted = array_values(array_sort($array, function ($value) {
return $value['name'];
}));
/*
[
['name' => 'Chair'],
['name' => 'Desk'],
['name' => 'Table'],
]
*/
array_sort_recursive()
array_sort_recursive
函数使用 sort
函数对数组进行递归排序:
$array = [
['Roman', 'Taylor', 'Li'],
['PHP', 'Ruby', 'JavaScript'],
];
$array = array_sort_recursive($array);
/*
[
['Li', 'Roman', 'Taylor'],
['JavaScript', 'PHP', 'Ruby'],
]
*/
array_where()
array_where
函数使用给定闭包对数组进行过滤:
$array = [100, '200', 300, '400', 500];
$array = array_where($array, function ($value, $key) {
return is_string($value);
});
// [1 => 200, 3 => 400]
array_wrap()
array_wrap
函数将给定值包裹到数组中,如果给定值已经是数组则保持不变:
$string = 'Laravel';
$array = array_wrap($string);
// ['Laravel']
如果给定值是空的,则返回一个空数组:
$nothing = null;
$array = array_wrap($nothing);
// []
data_fill()
data_fill
函数使用「.」号以嵌套数组或对象的方式设置缺失值:
$data = ['products' => ['desk' => ['price' => 100]]];
data_fill($data, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 100]]]
data_fill($data, 'products.desk.discount', 10);
// ['products' => ['desk' => ['price' => 100, 'discount' => 10]]]
该函数还接收「*」号作为通配符并填充相应目标:
$data = [
'products' => [
['name' => 'Desk 1', 'price' => 100],
['name' => 'Desk 2'],
],
];
data_fill($data, 'products.*.price', 200);
/*
[
'products' => [
['name' => 'Desk 1', 'price' => 100],
['name' => 'Desk 2', 'price' => 200],
],
]
*/
data_get()
data_get
函数使用「.」号从嵌套数组或对象中获取值:
$data = ['products' => ['desk' => ['price' => 100]]];
$price = data_get($data, 'products.desk.price');
// 100
data_get
函数还接收默认值,以便指定键不存在的情况下返回:
$discount = data_get($data, 'products.desk.discount', 0);
// 0
data_set()
data_set
函数使用 「.」号设置嵌套数组或对象的值:
$data = ['products' => ['desk' => ['price' => 100]]];
data_set($data, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 200]]]
data_set()
data_set
函数使用 「.」号设置嵌套数组或对象的值:
$data = ['products' => ['desk' => ['price' => 100]]];
data_set($data, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 200]]]
该函数还接收通配符然后设置相应的目标值:
$data = [
'products' => [
['name' => 'Desk 1', 'price' => 100],
['name' => 'Desk 2', 'price' => 150],
],
];
data_set($data, 'products.*.price', 200);
/*
[
'products' => [
['name' => 'Desk 1', 'price' => 200],
['name' => 'Desk 2', 'price' => 200],
],
]
*/
默认情况下,任意已存在的值都会被覆盖,如果你想要只设置不存在的值,可以传递 false
作为第三个参数:
$data = ['products' => ['desk' => ['price' => 100]]];
data_set($data, 'products.desk.price', 200, false);
// ['products' => ['desk' => ['price' => 100]]]
head()
head
函数只是简单返回给定数组的第一个元素:
$array = [100, 200, 300];
$first = head($array);
// 100
last()
last
函数返回给定数组的最后一个元素:
$array = [100, 200, 300];
$last = last($array);
// 300