引入包
use Illuminate\Support\Arr;
一、检查给定的值是否可数组式访问
Arr::accessible(['a' => 1, 'b' => 2]);// true二、数组添加
Arr::add(['name' => 'Desk'], 'price', 100) ;// ['name' => 'Desk', 'price' => 100]
Arr::add(['name' => 'Desk', 'price' => null], 'price', 100);// ['name' => 'Desk', 'price' => 100] 若添加的键值存在并且值为null，则会将null改为修改的值
三、数组修改
$array = ['products' => ['desk' => ['price' => 100]]];
Arr::set($array, 'products.desk.price', 200); // ['products' => ['desk' => ['price' => 200]]]
四、 数组删除
1.根据键值删除数组
Arr::except(['name' => 'Desk', 'price' => 100], ['price']);
// ['name' => 'Desk']2.从嵌套的数组中删除给定的键值对
Arr::forget(['products' => ['desk' => ['price' => 100]]], 'products.desk');
//['products' => []]五、查询
1.判断数组中指定键值是否存在
Arr::exists(['name' => 'John Doe', 'age' => 17], 'name');// true2. 判断数组中是否存在指定的一个或多个键
$array = ['product' => ['name' => 'Desk', 'price' => 100]];
$contains = Arr::has($array, 'product.name');// true
$contains = Arr::has($array, ['product.price', 'product.discount']);// false3.根据指定键查询数组，返回数组的值
$array = ['products' => ['desk' => ['price' => 100]]];
$price = Arr::get($array, 'products.desk.price');// 100
//函数也可以接受一个默认值，如果没有找到特定的键，将返回默认值
$discount = Arr::get($array, 'products.desk.discount', 0); //04.返回数组中满足指定条件的第一个/最后一个元素
$array = [100, 200, 300];
$first = Arr::first($array, function ($value, $key) {
return $value >= 150;
});// 200
//将默认值作为第三个参数传递给该方法，如果没有值满足条件，则返回该默认值：
$first = Arr::first($array, $callback, $default);
//函数返回数组中满足指定条件的最后一个元素用 last
$last = Arr::last($array, function ($value, $key) {
return $value >= 150;
}); //3005.根据条件查询数组
$array = [100, '200', 300, '400', 500];
$filtered = Arr::where($array, function ($value, $key) {
return is_string($value);
});
// [1 => '200', 3 => '400']6.根据指定的键查询数组，返回键值对（数组）
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
$slice = Arr::only($array, ['name', 'price']);
// ['name' => 'Desk', 'price' => 100]
7.根据指定的键，返回所有值(数组)
array = [
['developer' => ['id' => 1, 'name' => 'Taylor']],
['developer' => ['id' => 2, 'name' => 'Abigail']],
];
$names = Arr::pluck($array, 'developer.name');
// ['Taylor', 'Abigail']
##可以指定结果的键
$names = Arr::pluck($array, 'developer.name', 'developer.id');
// [1 => 'Taylor', 2 => 'Abigail']
8.从数组中随机返回一个或多个值
$array = [1, 2, 3, 4, 5];
$random = Arr::random($array);
//4
$items = Arr::random($array, 2);
// [2, 5] 返回数组六、数组操作
1.数组合并
Arr::collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);
//[1, 2, 3, 4, 5, 6, 7, 8, 9]2. 返回多个数组具有所有可能排列的笛卡尔乘积
Arr::crossJoin([1, 2], ['a', 'b']);
// [[1, 'a'],[1, 'b'],[2, 'a'],[2, 'b']]3.将多维数组中所有的 键 平铺到一维数组中，新数组使用「.」符号表示层级包含关系
Arr::dot(['products' => ['desk' => ['price' => 100]]]);
// ['products.desk.price' => 100]4.将多维数组中数组的 值 取出平铺为一维数组
Arr::flatten(['name' => 'Joe', 'languages' => ['PHP', 'Ruby']]);
// ['Joe', 'PHP', 'Ruby']5.使用「点表示法」的一维数组扩展为多维数组
$array = [
'user.name' => 'Kevin Malone',
'user.occupation' => 'Accountant',
];
$array = Arr::undot($array);
// ['user' => ['name' => 'Kevin Malone', 'occupation' => 'Accountant']]七、排序
1.随机排序
$array = Arr::shuffle([1, 2, 3, 4, 5]);
// [3, 2, 5, 1, 4] 2. 根据数组的值大小进行排序
$array = ['Desk', 'Table', 'Chair'];
$sorted = Arr::sort($array);
// ['Chair', 'Desk', 'Table']
//根据给定回调函数返回的结果对数组进行排序
$array = [
['name' => 'Desk'],
['name' => 'Table'],
['name' => 'Chair'],
];
$sorted = array_values(Arr::sort($array, function ($value) {
return $value['name'];
}));
/*
[
['name' => 'Chair'],
['name' => 'Desk'],
['name' => 'Table'],
]
*/3.递归排序
$array = [
['Roman', 'Taylor', 'Li'],
['PHP', 'Ruby', 'JavaScript'],
['one' => 1, 'two' => 2, 'three' => 3],
];
$sorted = Arr::sortRecursive($array);
/*
[
['JavaScript', 'PHP', 'Ruby'],
['one' => 1, 'three' => 3, 'two' => 2],
['Li', 'Roman', 'Taylor'],
]
*/八、其他
1.用于动态css赋值，根据给定的条件编译并返回 CSS 类字符串，为true 的返回
$isActive = false;
$hasError = true;
$array = ['p-4', 'font-bold' => $isActive, 'bg-red' => $hasError];
$classes = Arr::toCssClasses($array);
//'p-4 bg-red'九、数组函数
1.数组修改，给多维数组或对象设置缺少的值
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],
],
]
*/2. 数组修改，给多维数组或对象设置值
$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],
],
]
*/3.根据指定的键查询数组的值，返回String
$data = ['products' => ['desk' => ['price' => 100]]];
$price = data_get($data, 'products.desk.price'); //100
//该函数也接受一个默认值，如果没有找到指定的键，将返回默认值：
$discount = data_get($data, 'products.desk.discount', 0);// 0
//该函数还接受「*」为通配符,来指向数组或对象的任何键：
$data = [
'product-one' => ['name' => 'Desk 1', 'price' => 100],
'product-two' => ['name' => 'Desk 2', 'price' => 150],
];
data_get($data, '*.name');// ['Desk 1', 'Desk 2'];4.返回数组中的第一个/最后一个值
$array = [100, 200, 300];
$first = head($array);// 100
//last 函数将返回数组中的最后一个值
$array = [100, 200, 300];
$last = last($array);// 300
