diff --git a/QueryList.class.php b/QueryList.class.php
index 01dd960..fc92215 100644
--- a/QueryList.class.php
+++ b/QueryList.class.php
@@ -7,42 +7,93 @@
* @author Jaeger
* @email 734708094@qq.com
* @link http://git.oschina.net/jae/QueryList
- * @version 1.6.1
+ * @version 2.0.0
+ *
+ * @example
+ *
+ //获取CSDN移动开发栏目下的文章列表标题
+$hj = QueryList::Query('http://mobile.csdn.net/',array("title"=>array('.unit h1','text')));
+print_r($hj->jsonArr);
+
+//获取CSDN文章页下面的文章标题和内容
+$url = 'http://www.csdn.net/article/2014-06-05/2820091-build-or-buy-a-mobile-game-backend';
+$reg = array(
+ 'title'=>array('h1','text'), //获取纯文本格式的标题
+ 'summary'=>array('.summary','text','input strong'), //获取纯文本的文章摘要，但保留input和strong标签
+ 'content'=>array('.news_content','html','div a') //获取html格式的文章内容，但过滤掉div和a标签
+ );
+$rang = '.left';
+$hj = QueryList::Query($url,$reg,$rang,'curl');
+print_r($hj->jsonArr);
+
+//继续获取右边相关热门文章列表的标题以及链接地址
+$hj->setQuery(array('title'=>array('','text'),'url'=>array('a','href')),'#con_two_2 li');
+//输出json数据
+echo $hj->getJson();
*/
require 'phpQuery/phpQuery.php';
class QueryList
{
- private $pageURL;
private $regArr;
public $jsonArr;
private $regRange;
private $html;
private $outputEncoding;
private $htmlEncoding;
+ private static $ql;
/**
- * 构造函数
+ * 静态方法，访问入口
* @param string $page 要抓取的网页URL地址(支持https);或者是html源代码
- * @param array $regArr 【选择器数组】说明：格式array("名称"=>array("选择器","类型"),.......),【类型】说明：值 "text" ,"html" ,"属性"
+ * @param array $regArr 【选择器数组】说明：格式array("名称"=>array("选择器","类型"[,"标签列表"]),.......),【类型】说明：值 "text" ,"html" ,"属性" ,【标签列表】:可选，当【类型】值为text时表示需要保留的HTML标签，为html时表示要过滤掉的HTML标签
* @param string $regRange 【块选择器】：指 先按照规则 选出 几个大块 ，然后再分别再在块里面 进行相关的选择
* @param string $getHtmlWay 【源码获取方式】指是通过curl抓取源码，还是通过file_get_contents抓取源码
* @param string $outputEncoding【输出编码格式】指要以什么编码输出(UTF-8,GB2312,.....)，防止出现乱码,如果设置为 假值 则不改变原字符串编码
*/
- public function __construct($page, $regArr, $regRange = '', $getHtmlWay = 'curl', $outputEncoding = false)
+ public static function Query($page, $regArr, $regRange = '', $getHtmlWay = 'curl', $outputEncoding = false)
{
+ if(!(self::$ql instanceof self))
+ {
+ self::$ql = new self();
+ }
+ self::$ql->_query($page, $regArr, $regRange, $getHtmlWay, $outputEncoding);
+ return self::$ql;
+ }
+ /**
+ * 重新设置选择器
+ * @param array $regArr 选择器数组
+ * @param string $regRange 块选择器
+ */
+ public function setQuery($regArr, $regRange = '')
+ {
+ $this->jsonArr = array();
+ $this->regArr = $regArr;
+ $this->regRange = $regRange;
+ $this->_getList();
+ }
+ /**
+ * 得到JSON结构的结果
+ * @return string
+ */
+ public function getJSON()
+ {
+ return json_encode($this->jsonArr);
+ }
+ private function _query($page, $regArr, $regRange, $getHtmlWay, $outputEncoding)
+ {
+ $this->jsonArr = array();
$this->outputEncoding = $outputEncoding;
if ($this->_isURL($page)) {
- $this->pageURL = $page;
if ($getHtmlWay == 'curl') {
//为了能获取https://
$ch = curl_init();
- curl_setopt($ch, CURLOPT_URL, $this->pageURL);
+ curl_setopt($ch, CURLOPT_URL, $page);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$this->html = curl_exec($ch);
curl_close($ch);
} else {
- $this->html = file_get_contents($this->pageURL);
+ $this->html = file_get_contents($page);
}
} else {
$this->html = $page;
@@ -55,13 +106,6 @@ class QueryList
$this->_getList();
}
}
- public function setQuery($regArr, $regRange = '')
- {
- $this->jsonArr = array();
- $this->regArr = $regArr;
- $this->regRange = $regRange;
- $this->_getList();
- }
private function _getList()
{
$hobj = phpQuery::newDocumentHTML($this->html);
@@ -70,13 +114,14 @@ class QueryList
$i = 0;
foreach ($robj as $item) {
while (list($key, $reg_value) = each($this->regArr)) {
+ $tags = isset($reg_value[2])?$reg_value[2]:'';
$iobj = pq($item)->find($reg_value[0]);
switch ($reg_value[1]) {
case 'text':
- $this->jsonArr[$i][$key] = trim(pq($iobj)->text());
+ $this->jsonArr[$i][$key] = $this->_allowTags(pq($iobj)->html(),$tags);
break;
case 'html':
- $this->jsonArr[$i][$key] = trim(pq($iobj)->html());
+ $this->jsonArr[$i][$key] = $this->_stripTags(pq($iobj)->html(),$tags);
break;
default:
$this->jsonArr[$i][$key] = pq($iobj)->attr($reg_value[1]);
@@ -89,15 +134,16 @@ class QueryList
}
} else {
while (list($key, $reg_value) = each($this->regArr)) {
+ $tags = isset($reg_value[2])?$reg_value[2]:'';
$lobj = pq($hobj)->find($reg_value[0]);
$i = 0;
foreach ($lobj as $item) {
switch ($reg_value[1]) {
case 'text':
- $this->jsonArr[$i++][$key] = trim(pq($item)->text());
+ $this->jsonArr[$i++][$key] = $this->_allowTags(pq($item)->html(),$tags);
break;
case 'html':
- $this->jsonArr[$i++][$key] = trim(pq($item)->html());
+ $this->jsonArr[$i++][$key] = $this->_stripTags(pq($item)->html(),$tags);
break;
default:
$this->jsonArr[$i++][$key] = pq($item)->attr($reg_value[1]);
@@ -111,10 +157,6 @@ class QueryList
$this->jsonArr = $this->_arrayConvertEncoding($this->jsonArr, $this->outputEncoding, $this->htmlEncoding);
}
}
- public function getJSON()
- {
- return json_encode($this->jsonArr);
- }
/**
* 获取文件编码
* @param $string
@@ -157,4 +199,36 @@ class QueryList
}
return false;
}
-}
\ No newline at end of file
+ /**
+ * 去除特定的html标签
+ * @param string $html
+ * @param string $tags 多个标签名之间用空格隔开
+ * @return string
+ */
+ private function _stripTags($html,$tags)
+ {
+ $tagsArr = preg_split("/\s+/",$tags,-1,PREG_SPLIT_NO_EMPTY);
+ $p = array();
+ foreach ($tagsArr as $tag) {
+ $p[]="/(<(?:\/".$tag."|".$tag.")[^>]*>)/i";
+ }
+ $html = preg_replace($p,"",trim($html));
+ return $html;
+ }
+ /**
+ * 保留特定的html标签
+ * @param string $html
+ * @param string $tags 多个标签名之间用空格隔开
+ * @return string
+ */
+ private function _allowTags($html,$tags)
+ {
+ $tagsArr = preg_split("/\s+/",$tags,-1,PREG_SPLIT_NO_EMPTY);
+ $allow = '';
+ foreach ($tagsArr as $tag) {
+ $allow .= "<$tag> ";
+ }
+ return strip_tags(trim($html),$allow);
+ }
+}
+
diff --git a/README.md b/README.md
index 8119635..8132842 100644
--- a/README.md
+++ b/README.md
@@ -1 +1 @@
-
#QueryList交流QQ群:123266961 <a target="_blank" href="http://shang.qq.com/wpa/qunwpa?idkey=a1b248ae30b3f711bdab4f799df839300dc7fed54331177035efa0513da027f6"><img border="0" src="http://pub.idqqimg.com/wpa/images/group.png" alt="╰☆邪恶 魔方☆" title="╰☆邪恶 魔方☆"></a>
#QueryList简介
***
QueryList是一个基于phpQuery的通用列表采集类,是一个简单、 灵活、强大的采集工具，采集任何复杂的页面 基本上就一句话就能搞定了。
#QueryList 使用
```php
//实例化一个采集对象
$hj = new QueryList('http://www.baidu.com/s?wd=jaekj',array('title'=>array('h3','text')));
//输出结果：二维关联数组
print_r($hj->jsonArr);
//输出结果：JSON数据
echo $hj->getJSON();
```
上面的代码实现的功能是采集百度搜索结果页面的所有搜索结果的标题,然后分别以数组和JSON格式输出。
###QueryList 构造函数原型：
>***QueryList***($page,$regArr,$regRange='',$getHtmlWay="curl",$output_encoding=false)
一共有五个参数，后面三个参数是可选的
* *$page* 要抓取的网页URL地址(默认支持https);或者是html源代码
* *$regArr* 【选择器数组】说明：格式array("名称"=>array("选择器","类型"),.......),【类型】说明：值 "text" ,"html" ,"属性"
* *$regRange* 【块选择器】：指 先按照规则 选出 几个大块 ，然后再分别再在块里面 进行相关的选择
* *$getHtmlWay* 【源码获取方式】指是通过curl抓取源码，还是通过file\_get_contents抓取源码,当$page参数为URL时此参数才有效
* *$output_encoding*【输出编码格式】指要以什么编码输出(UTF-8,GB2312,.....)，防止出现乱码,如果设置为 假值 则不改变原字符串编码
###QueryList 属性
* **得到多维数组格式的采集结果**
>***jsonArr***
###QueryList 方法
* **重新设置选择器**
>void ***setQuery***($regArr,$regRange='')
一共两个参数,第二个参数是可选的，参数意义同构造函数。
* **得到JSON格式的采集结果**
> string ***getJSON***()
无参，返回JSON字符串。
##QueryList 依赖库
```
phpQuery
```
phpQuery项目主页:[https://code.google.com/p/phpquery/](https://code.google.com/p/phpquery/)
##其它说明
QueryList 内置的只是简单的源码抓取方法，遇到更复杂的抓取情况，如：需要登陆
身份验证 时，请配合其它的PHP的HTTP类来使用，通过将辅助的HTTP类抓取到的网页源码传给QueryList即可。
##DEMO站
微动态:[http://querylist.jaekj.com/](http://querylist.jaekj.com/)
* thinkphp版本:V3.1.2
* QueryList版本:V1.6
* 后台地址: /admin
* 后台账号密码: guest guest
这个demo站实现的功能相当于一个轻量级的微博站，内容全自动采集更新，可以自定义时间间隔采集任意站点的信息，自动更新到这个站点来，只需要在后台规则库简单的添加一条规则就可以实现全自动采集了，大家可以自行进入后台进行尝试，体验QueryList的魅力！
##作者信息
```
Author : Jaeger
Email : hj.q@qq.com
交流QQ群:123266961
```
\ No newline at end of file
+
#QueryList交流QQ群:123266961 <a target="_blank" href="http://shang.qq.com/wpa/qunwpa?idkey=a1b248ae30b3f711bdab4f799df839300dc7fed54331177035efa0513da027f6"><img border="0" src="http://pub.idqqimg.com/wpa/images/group.png" alt="╰☆邪恶 魔方☆" title="╰☆邪恶 魔方☆"></a>
#QueryList简介
***
QueryList是一个基于phpQuery的通用列表采集类,是一个简单、 灵活、强大的采集工具，采集任何复杂的页面 基本上就一句话就能搞定了。
#QueryList 使用
```php
//获取采集对象
$hj = QueryList::Query('http://www.baidu.com/s?wd=jaekj',array('title'=>array('h3','text')));
//输出结果：二维关联数组
print_r($hj->jsonArr);
//输出结果：JSON数据
echo $hj->getJSON();
```
上面的代码实现的功能是采集百度搜索结果页面的所有搜索结果的标题,然后分别以数组和JSON格式输出。
###QueryList 静态方法Query原型：
>***Query***($page,$regArr,$regRange='',$getHtmlWay="curl",$output_encoding=false)
一共有五个参数，后面三个参数是可选的
* *$page* 要抓取的网页URL地址(默认支持https);或者是html源代码
* *$regArr* 【选择器数组】说明：格式array("名称"=>array("选择器","类型"[,"标签列表"]),.......),【类型】说明：值 "text" ,"html" ,"属性" ,【标签列表】:可选，当【类型】值为text时表示需要保留的HTML标签，为html时表示要过滤掉的HTML标签
* *$regRange* 【块选择器】：指 先按照规则 选出 几个大块 ，然后再分别再在块里面 进行相关的选择
* *$getHtmlWay* 【源码获取方式】指是通过curl抓取源码，还是通过file\_get_contents抓取源码,当$page参数为URL时此参数才有效
* *$output_encoding*【输出编码格式】指要以什么编码输出(UTF-8,GB2312,.....)，防止出现乱码,如果设置为 假值 则不改变原字符串编码
###QueryList 属性
* **得到多维数组格式的采集结果**
>***jsonArr***
###QueryList 方法
* **重新设置选择器**
>void ***setQuery***($regArr,$regRange='')
一共两个参数,第二个参数是可选的，参数意义同构造函数。
* **得到JSON格式的采集结果**
> string ***getJSON***()
无参，返回JSON字符串。
##QueryList 依赖库
```
phpQuery
```
phpQuery项目主页:[https://code.google.com/p/phpquery/](https://code.google.com/p/phpquery/)
##其它说明
QueryList 内置的只是简单的源码抓取方法，遇到更复杂的抓取情况，如：需要登陆
身份验证 时，请配合其它的PHP的HTTP类来使用，通过将辅助的HTTP类抓取到的网页源码传给QueryList即可。
##DEMO站
微动态:[http://querylist.jaekj.com/](http://querylist.jaekj.com/)
* thinkphp版本:V3.1.2
* QueryList版本:V1.6
* 后台地址: /admin
* 后台账号密码: guest guest
这个demo站实现的功能相当于一个轻量级的微博站，内容全自动采集更新，可以自定义时间间隔采集任意站点的信息，自动更新到这个站点来，只需要在后台规则库简单的添加一条规则就可以实现全自动采集了，大家可以自行进入后台进行尝试，体验QueryList的魅力！
##作者信息
```
Author : Jaeger
Email : hj.q@qq.com
交流QQ群:123266961
```
##支持作者
如果您觉得 QueryList 对您非常有用并希望QueryList能越来越好，您可以考虑通过捐赠来支持作者，您的帮助是对作者最大的支持和动力。
<center> 
用手机扫描二位码支付</center>
\ No newline at end of file
diff --git a/demo/Searcher.class.php b/demo/Searcher.class.php
index 442a102..4d52815 100644
--- a/demo/Searcher.class.php
+++ b/demo/Searcher.class.php
@@ -48,7 +48,7 @@ require '../QueryList.class.php';
$reg_znum='/([\d,]+) result(s)?/';
$getHtmlWay = 'curl';
}
- $searcherObj = new QueryList($url,$this->regArr,$this->regRange,$getHtmlWay,false);
+ $searcherObj = QueryList::Query($url,$this->regArr,$this->regRange,$getHtmlWay,false);
for($i=0;$i<count($searcherObj->jsonArr);$i++)
{
if($this->searcher=='baidu')
diff --git a/demo/demo.php b/demo/demo.php
index 7b6a119..63eb10b 100644
--- a/demo/demo.php
+++ b/demo/demo.php
@@ -6,7 +6,7 @@ $url = "http://www.oschina.net/code/list";
$reg = array("title"=>array(".code_title a:eq(0)","text"),"url"=>array(".code_title a:eq(0)","href"),"author"=>array("img","title"));
$rang = ".code_list li";
//使用curl抓取源码并以GB2312编码格式输出
-$hj = new QueryList($url,$reg,$rang,'curl','GB2312');
+$hj = QueryList::Query($url,$reg,$rang,'curl','GB2312');
$arr = $hj->jsonArr;
echo "<pre>";
print_r($arr);
@@ -21,7 +21,7 @@ echo $json . "<hr/>";
//采OSC内容页内容
$url = "http://www.oschina.net/code/snippet_186288_23816";
$reg = array("title"=>array(".QTitle h1","text"),"con"=>array(".Content","html"));
-$hj = new QueryList($url,$reg);
+$hj = QueryList::Query($url,$reg);
$arr = $hj->jsonArr;
echo "<pre>";
print_r($arr);
diff --git a/demo/thanks.png b/demo/thanks.png
new file mode 100644
index 0000000..b5c72a7
Binary files /dev/null and b/demo/thanks.png differ