PHPackages                             hanxiaoqingcheng/querylist - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hanxiaoqingcheng/querylist

ActiveLibrary[Utility & Helpers](/categories/utility)

hanxiaoqingcheng/querylist
==========================

QueryList是基于phpQuery的无比强大的PHP采集工具

v1.0.0(3y ago)0181MITPHPPHP >=5.3.0

Since Oct 13Pushed 3y ago1 watchersCompare

[ Source](https://github.com/hanxiaoqingcheng/querylist)[ Packagist](https://packagist.org/packages/hanxiaoqingcheng/querylist)[ Docs](http://querylist.cc)[ RSS](/packages/hanxiaoqingcheng-querylist/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (2)Used By (0)

QueryList简介
===========

[](#querylist简介)

---

`QueryList`是一个基于`phpQuery`的通用列表采集类,是一个简单、 灵活、强大的采集工具，采集任何复杂的页面 基本上就一句话就能搞定了。

QueryList 安装
============

[](#querylist-安装)

通过`composer`安装:

```
composer require hanxiaoqingcheng/querylist

```

更多安装方法:[QueryList多种安装方式](https://doc.querylist.cc/site/index/doc/7)

QueryList 使用
============

[](#querylist-使用)

下面演示`QueryList`用一句代码采集百度搜索结果：

```
//获取采集对象
$hj = QueryList::Query('http://www.baidu.com/s?wd=QueryList',array(
        'title'=>array('h3','text'),
        'link'=>array('h3>a','href')
    ));
//输出结果：二维关联数组
print_r($hj->data);
```

上面的代码实现的功能是采集百度搜索结果页面的所有搜索结果的`标题`和`链接`,然后分别以二维关联数组的格式输出。

采集结果:

```
Array
(
    [0] => Array
        (
            [title] => QueryList|基于phpQuery的无比强大的PHP采集工具
            [link] => http://www.baidu.com/link?url=IIsMhpzI2PylnmW8vPALcwIfJgHhKFu2SWXEj7yQ-6o7KStbLfmuoWGmalpx1xYE
        )

    [1] => Array
        (
            [title] => 介绍- QueryList指导文档
            [link] => http://www.baidu.com/link?url=edktLqt6f9KwYJ6oip1EDXvwIXh-nHcFImVJeqRm56-VU3zIcqLRYeM83VyYQE_X
        )

  //省略....

)

```

Query() 静态方法
------------

[](#query-静态方法)

返回值:`QueryList对象`

Query方法为`QueryList`唯一的主方法，用静态的方式调用。

**原型:**

> QueryList::Query($page,array $rules, $range = '', $outputEncoding = null, $inputEncoding = null,$removeHead = false)

**中文解释:**

```
QueryList::Query(采集的目标页面,采集规则[,区域选择器][，输出编码][，输入编码][，是否移除头部])
//采集规则
$rules = array(
   '规则名' => array('jQuery选择器','要采集的属性'[,"标签过滤列表"][,"回调函数"]),
   '规则名2' => array('jQuery选择器','要采集的属性'[,"标签过滤列表"][,"回调函数"]),
    ..........
    [,"callback"=>"全局回调函数"]
);

//注:方括号括起来的参数可选

```

### 参数解释:

[](#参数解释)

查看文档:

QueryList 扩展
------------

[](#querylist-扩展)

**Request 网络操作扩展**

```
可以实现如携带cookie、伪造来路等任意复杂的网络请求，再也不用担心QueryList内置的抓取功能太弱了。

```

**Login 模拟登陆扩展**

```
可以实现模拟登陆然后采集。

```

**Multi 多线程插件**

```
多线程（多进程）采集扩展。

```

**DImage图片下载扩展**

```
可实现简单的图片下载需求。

```

扩展安装以及使用教程:[QueryList扩展文档](https://doc.querylist.cc/site/index/doc/19)，获取更多扩展可以关注`QueryList`社区和交流群。

其它说明
----

[](#其它说明)

1.`QueryList`内置的只是简单的源码抓取方法，遇到更复杂的抓取情况，如：需要登陆 身份验证 时，请配合其它的PHP的HTTP工具(推荐使用[Guzzle](http://guzzle-cn.readthedocs.io/zh_CN/latest/))来使用，通过将辅助的HTTP类抓取到的网页源码传给`QueryList`即可。

2.采集程序请在PHP命令行模式(PHP CLI)下运行。

3.`QueryList`依赖`phpQuery`,`phpQuery`项目主页:[phpQuery文档](https://code.google.com/p/phpquery/)

寻求帮助?
-----

[](#寻求帮助)

- QueryList交流社区:
- QueryList文档:
- QueryList交流QQ群:123266961 [![╰☆邪恶 魔方☆](https://camo.githubusercontent.com/d8a86bc02a44a78d23d0746f300d73b0f9bb7e9a1f9eb6af61b2f159525f317d/687474703a2f2f7075622e69647171696d672e636f6d2f7770612f696d616765732f67726f75702e706e67 "╰☆邪恶 魔方☆")](http://shang.qq.com/wpa/qunwpa?idkey=a1b248ae30b3f711bdab4f799df839300dc7fed54331177035efa0513da027f6)
- Git@OSC:
- GitHub:

Author
------

[](#author)

Jaeger

Lisence
-------

[](#lisence)

QueryList is licensed under the license of MIT. See the LICENSE for more details.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1358d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/060cf0cee7b7e9c9f29279fd7861a51a68282e783e5464e9eb33d5301b5e1bc6?d=identicon)[hanxiaoqingcheng](/maintainers/hanxiaoqingcheng)

---

Tags

spiderphpQueryQueryList

### Embed Badge

![Health badge](/badges/hanxiaoqingcheng-querylist/health.svg)

```
[![Health](https://phpackages.com/badges/hanxiaoqingcheng-querylist/health.svg)](https://phpackages.com/packages/hanxiaoqingcheng-querylist)
```

###  Alternatives

[jaeger/querylist

Simple, elegant, extensible PHP Web Scraper (crawler/spider),Use the css3 dom selector,Based on phpQuery! 简洁、优雅、可扩展的PHP采集工具(爬虫)，基于phpQuery。

2.8k657.7k88](/packages/jaeger-querylist)[vdb/php-spider

A configurable and extensible PHP web spider

1.3k185.8k7](/packages/vdb-php-spider)[jaybizzle/laravel-crawler-detect

A Laravel package to detect web crawlers via the user agent

3302.7M18](/packages/jaybizzle-laravel-crawler-detect)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)