phpQuery 採集網頁完整指南：jQuery 語法解析 HTML/XML

什麼是 phpQuery？

phpQuery 是 PHP 版 jQuery，支援 CSS 選擇器、DOM 遍歷、操作操作，讓伺服器端採集網頁如同瀏覽器端般直觀。

安裝與基本使用

<?php
require_once 'phpQuery/phpQuery.php'; // 或 composer require electrolinux/phpquery

// 從 URL 載入
phpQuery::newDocumentFile('https://example.com/news');
$title = pq('.headline h1:eq(0)')->html();
echo $title;

// 從字串載入
$html = file_get_contents('https://example.com');
phpQuery::newDocument($html);
$links = pq('a')->attr('href');

常見選擇器與操作

採集文章列表範例

<?php
phpQuery::newDocumentFile('https://blog.example.com');
$articles = [];

foreach (pq('.post-list .post') as $post) {
    $pq = pq($post); // 重要：包裝為 phpQuery 物件
    $articles[] = [
        'title'   => $pq->find('h2 a')->text(),
        'url'     => $pq->find('h2 a')->attr('href'),
        'summary' => $pq->find('.excerpt')->text(),
        'date'    => $pq->find('.meta .date')->attr('datetime'),
    ];
}
print_r($articles);

解析 XML 文件

<?php
$xml = <<<XML
<?xml version="1.0" encoding="utf-8"?>
<root>
  <contact><name>張三</name><age>22</age></contact>
  <contact><name>王五</name><age>18</age></contact>
</root>
XML;

phpQuery::newDocument($xml, 'text/xml'); // 指定 MIME 類型
$age = pq('contact:eq(0) > age')->text(); // 22
echo $age;

記憶體洩漏問題與解決

phpQuery 內部靜態陣列 phpQuery::$documents 會保存所有解析過的文件，大量採集導致記憶體暴增。

<?php
// 錯誤示範：記憶體持續增長
while ($url = $queue->pop()) {
    phpQuery::newDocumentFile($url);
    // 處理...
}

// 正確：每次解析後清理
while ($url = $queue->pop()) {
    phpQuery::newDocumentFile($url);
    // 處理...
    phpQuery::$documents = []; // 釋放文件物件
    // 或 unset(phpQuery::$documents[$id]);
}

進階技巧

• 處理編碼：phpQuery::newDocument($html, 'utf-8') 或先 iconv()
• 表單模擬：pq('form')->find('input[name=token]')->val('abc') 修改表單值
• AJAX 內容：phpQuery 無法執行 JS，動態內容需配合 Selenium/Headless Chrome
• 錯誤處理：try { phpQuery::newDocumentFile($url); } catch (Exception $e) { log($e); }

替代方案比較

1. 上一篇文章： PHP 靜態變數實作函式級快取：避免重複資料庫查詢
2. 下一篇文章： phpQuery 記憶體洩漏根因分析與解決方案

PHP 綜合知識

程式設計師 520 表白神器：代碼情書與動態圖片完整合集

延續上一篇，本文整理另一組 520 表白素材，包含更多動態圖

ThinkPHP 整合 PHPMailer 發送郵件完整教學：多附件、內嵌圖片、SMTP 配置

準備工作：安裝 PHPMailer # 方式 1：Compo

PHP 檔案與目錄操作完全指南：基礎屬性、遍歷、刪除、複製、大小統計實戰代碼庫

PHP 內建豐富的檔案系統函式，掌握核心 API 能高效完成

PHP preg_replace 多模式遞迴替換機制詳解與實例

函數原型 mixed preg_replace ( mixe