Question

QueryList返回的集合数据均为Collection集合对象而非普通数组，目的就是为了方便处理采集结果数据。

---

QueryList引入了Laravel中Collection集合对象，它提供了一个更具可读性的、更便于处理数组数据的封装。下面通过几个例子来说明它的用法，更多用法可以去查看Laravel文档。

Collection文档：https://d.laravel-china.org/docs/5.4/collections

例子

采集所有图片链接，采集目标：

$html =<<<STR
    <div class="xx">
        <img data-src="/path/to/1.jpg" alt="">
    </div>
    <div class="xx">
        <img data-src="/path/to/2.jpg" alt="">
    </div>
    <div class="xx">
        <img data-src="/path/to/3.jpg" alt="">
    </div>
STR;

采集代码:

 $data = QueryList::html($html)->rules([
        'image' => ['img','data-src']
    ])->range('.xx')->query()->getData(function($item){
        return $item;
    });
print_r($data->all());

采集结果:

Array
(
    [0] => Array
        (
            [image] => /path/to/1.jpg
        )
    [1] => Array
        (
            [image] => /path/to/2.jpg
        )
    [2] => Array
        (
            [image] => /path/to/3.jpg
        )
)

---

简化数据

如果我们想要的结果是一位数组，而非二位数组，那该怎么做呢？

可以使用flatten()方法将多维集合转为一维的，对上面的采集结果data进行处理:

$rt = $data->flatten()->all();
print_r($rt);

输出结果:

Array
(
    [0] => /path/to/1.jpg
    [1] => /path/to/2.jpg
    [2] => /path/to/3.jpg
)

截取数据

如果我们只想要前2条数据，其它数据都是多余的，那该怎么做呢？

take() 方法返回给定数量项目的新集合，对最初的采集结果data进行处理:

$rt = $data->take(2)->all();
print_r($rt);

输出结果:

Array
(
    [0] => Array
        (
            [image] => /path/to/1.jpg
        )

    [1] => Array
        (
            [image] => /path/to/2.jpg
        )

)

你也可以传入负整数从集合末尾开始获取指定数量的项目，下面获取data数据中最后2条数据：

$rt = $data->take(-2)->all();
print_r($rt);

输出结果:

Array
(
    [1] => Array
        (
            [image] => /path/to/2.jpg
        )

    [2] => Array
        (
            [image] => /path/to/3.jpg
        )

)

翻转数据顺序

某些情况下我们需要翻转数据顺序，比如：采集论坛的帖子列表，帖子默认是按照发布日期由新到旧排序的，但我们把这些数据存入数据库的时候，想要按照发布日期由旧到新存入。

reverse() 方法用来倒转集合中项目的顺序:

$rt = $data->reverse()->all();
print_r($rt);

输出结果:

Array
(
    [2] => Array
        (
            [image] => /path/to/3.jpg
        )

    [1] => Array
        (
            [image] => /path/to/2.jpg
        )

    [0] => Array
        (
            [image] => /path/to/1.jpg
        )

)

过滤数据

filter()方法用于按条件过滤数据，只保留满足条件的数据。

下面例子过滤掉图片路径为/path/to/2.jpg的值。

采集代码:

 $rt = $data->filter(function($item){
    return $item['image'] != '/path/to/2.jpg';
})->all();

print_r($rt);

采集果:

Array
(
    [0] => Array
        (
            [image] => /path/to/1.jpg
        )

    [2] => Array
        (
            [image] => /path/to/3.jpg
        )

)

遍历数据，依次处理每一项数据

map() 方法遍历集合并将每一个值传入给定的回调。该回调可以任意修改项目并返回，从而形成新的被修改过项目的集合。下面遍历data并补全图片链接地址：

$rt = $data->map(function($item){
    $item['image'] = 'http://xxx.com'.$item['image'];
    return $item;
})->all();
print_r($rt);

输出结果：

Array
(
    [0] => Array
        (
            [image] => https://www.wenjiangs.com/wp-content/uploads/2021/docimg6/22-rrntthq3yr5.jpg
        )

    [1] => Array
        (
            [image] => https://www.wenjiangs.com/wp-content/uploads/2021/docimg6/23-vcndyohp0no.jpg
        )

    [2] => Array
        (
            [image] => https://www.wenjiangs.com/wp-content/uploads/2021/docimg6/24-yhc2oj0ik0t.jpg
        )

)

连贯操作

Collection对象的所有方法都是可以连贯操作的，比如下面操作,先翻转数数据顺序，然后补全图片链接，最后截取前2条数据:

$rt = $data->reverse()->map(function($item){
    $item['image'] = 'http://xxx.com'.$item['image'];
    return $item;
})->take(2)->all();
print_r($rt);

输出结果：

Array
(
    [2] => Array
        (
            [image] => https://www.wenjiangs.com/wp-content/uploads/2021/docimg6/24-yhc2oj0ik0t.jpg
        )

    [1] => Array
        (
            [image] => https://www.wenjiangs.com/wp-content/uploads/2021/docimg6/23-vcndyohp0no.jpg
        )

)

{primary} 大家可以举一反三，更多用法查看Collection文档。