使用PHP绕过Cloudflare进行网页抓取：Puphpeteer实战教程-php教程-PHP中文网

使用PHP绕过Cloudflare进行网页抓取：Puphpeteer实战教程

花韻仙語

发布： 2025-09-21 19:47:28

原创

376人浏览过

使用PHP绕过Cloudflare进行网页抓取：Puphpeteer实战教程

本文针对PHP在抓取受Cloudflare保护的网页时遇到的'error code: 1020'问题，提供了一种基于Puphpeteer的解决方案。通过模拟真实浏览器行为，启用JavaScript并禁用无头模式，Puphpeteer能够有效绕过Cloudflare的检测机制，实现对目标页面内容的成功获取，尤其适用于需要提取表单数据等场景。

理解Cloudflare保护与传统抓取挑战

在进行网页抓取时，开发者常会遇到“error code: 1020”这样的错误，这通常意味着请求被cloudflare等内容分发网络（cdn）或安全服务所阻止。cloudflare通过多种机制来识别和阻止自动化脚本，包括但不限于：

JavaScript挑战： 要求浏览器执行JavaScript以验证其非机器人身份。
CAPTCHA验证： 弹出验证码要求用户手动解决。
HTTP头部检测： 分析请求头信息，识别非浏览器发出的请求。

传统的PHP抓取方法，如file_get_contents()或cURL，仅发送HTTP请求，不具备执行JavaScript的能力，因此在遇到Cloudflare的JavaScript挑战时会直接失败。为了成功抓取这类受保护的页面，我们需要一个能够模拟真实浏览器环境、执行JavaScript的工具。

Puphpeteer：PHP的浏览器自动化解决方案

Puphpeteer是Nesk开发的一个PHP库，它为Google Chrome/Chromium的自动化工具Puppeteer提供了PHP接口。通过Puphpeteer，PHP开发者可以：

启动一个浏览器实例（Chrome或Chromium）。
导航到指定URL。
执行JavaScript代码。
获取页面完整的渲染内容。
与页面元素进行交互（点击、填写表单等）。

这些功能使得Puphpeteer成为绕过Cloudflare等反爬机制的理想选择，因为它能够模拟真实用户的浏览行为。

环境准备与安装

使用Puphpeteer需要PHP环境、Composer（PHP包管理器）以及Node.js和npm（用于安装Puppeteer的底层JavaScript库）。

立即学习“PHP免费学习笔记（深入）”；

安装Composer: 如果尚未安装，请访问Composer官网获取安装指南。

虎课网
虎课网是超过1800万用户信赖的自学平台，拥有海量设计、绘画、摄影、办公软件、职业技能等优质的高清教程视频，用户可以根据行业和兴趣爱好，自主选择学习内容，每天免费学习一个...

62

查看详情
安装Node.js和npm: 访问Node.js官网下载并安装。npm会随Node.js一同安装。
安装Puphpeteer及其依赖: 在你的项目根目录下，打开命令行工具，执行以下命令：
```
composer require nesk/puphpeteer
npm install @nesk/puphpeteer
```
登录后复制
composer require nesk/puphpeteer 会安装Puphpeteer的PHP部分。 npm install @nesk/puphpeteer 会安装Puppeteer的JavaScript部分，这是Puphpeteer在后台实际调用的浏览器自动化库。

编写抓取脚本

以下是一个使用Puphpeteer抓取Cloudflare保护页面的PHP脚本示例。我们将以获取页面中的CSRF令牌为例。

<?php

use Nesk\Puphpeteer\Puppeteer;

require_once __DIR__ . "/vendor/autoload.php";

/**
 * 从页面HTML内容中提取CSRF令牌
 * @param string $content 页面HTML内容
 * @return string|null CSRF令牌或null
 */
function getToken($content): ?string
{
    // 使用正则表达式匹配隐藏输入字段中的csrfmiddlewaretoken值
    if (preg_match('/input type="hidden" name="csrfmiddlewaretoken" value="(.+?)"/sim', $content, $matches)) {
        return $matches[1];
    }
    return null;
}

// 初始化Puppeteer并启动浏览器实例
$puppeteer = new Puppeteer;

// 启动浏览器时，禁用headless模式对于绕过Cloudflare至关重要。
// 'headless' => false 意味着会打开一个可见的浏览器窗口，
// 模拟真实用户操作，从而更有效地通过Cloudflare的检测。
$browser = $puppeteer->launch(['headless' => false]);

try {
    /**
     * @var \Nesk\Puphpeteer\Resources\Page $page
     * 创建一个新的页面实例
     */
    $page = $browser->newPage();
    $targetUrl = 'https://v2.gcchmc.org/medical-status-search/'; // 目标URL
    echo "正在访问目标页面: " . $targetUrl . PHP_EOL;

    // 导航到目标URL
    $page->goto($targetUrl);

    // 等待页面加载完成或Cloudflare挑战通过。
    // 在某些情况下，可能需要添加额外的等待机制，例如：
    // $page->waitForSelector('#some-element-after-load', ['timeout' => 10000]); // 等待某个元素出现
    // $page->waitForTimeout(5000); // 简单等待5秒，不推荐作为通用解决方案

    // 获取页面完整的渲染HTML内容
    $pageContent = $page->content();
    echo "页面内容获取成功，正在尝试提取CSRF令牌..." . PHP_EOL;

    // 提取CSRF令牌
    $csrfToken = getToken($pageContent);

    if ($csrfToken) {
        echo "成功获取CSRF令牌: " . $csrfToken . PHP_EOL;
    } else {
        echo "未在页面中找到CSRF令牌。" . PHP_EOL;
    }

    // 可以在此处添加更多交互操作，例如：
    // $page->type('#id_of_input_field', 'your_input_value'); // 填写输入框
    // $page->click('#id_of_submit_button'); // 点击按钮
    // $page->waitForNavigation(); // 等待页面跳转

} catch (\Exception $e) {
    echo "抓取过程中发生错误: " . $e->getMessage() . PHP_EOL;
} finally {
    // 确保无论成功与否，浏览器实例最终都会被关闭，释放资源。
    if (isset($browser)) {
        $browser->close();
        echo "浏览器已关闭。" . PHP_EOL;
    }
}

登录后复制

代码解析：

use Nesk\Puphpeteer\Puppeteer;: 导入Puphpeteer类。
require_once __DIR__ . "/vendor/autoload.php";: 加载Composer自动加载文件，使Puphpeteer类可用。
getToken($content) 函数: 这是一个辅助函数，用于通过正则表达式从页面HTML中提取特定的数据（此处是CSRF令牌）。
$puppeteer = new Puppeteer;: 创建一个Puphpeteer实例。
$browser = $puppeteer->launch(['headless' => false]);: 启动一个Chrome/Chromium浏览器实例。'headless' => false 是关键，它会启动一个可见的浏览器窗口。Cloudflare通常能检测到无头浏览器（headless: true），因此禁用无头模式能够更好地模拟真实用户，从而绕过其检测。
$page = $browser->newPage();: 在浏览器中打开一个新页面。
$page->goto($targetUrl);: 导航到目标URL。Puphpeteer会等待页面加载完成，包括JavaScript的执行。
$page->content();: 获取当前页面的完整HTML内容，这包括了JavaScript渲染后的结果。
$browser->close();: 关闭浏览器实例，释放系统资源。这是一个重要的清理步骤。

注意事项与进阶应用

性能与资源消耗： headless: false 模式会启动一个完整的浏览器窗口，这比无头模式消耗更多的系统资源（内存、CPU），并且在服务器环境下可能需要图形界面支持（例如使用XVFB等虚拟显示服务器）。对于生产环境的大规模抓取，这可能是一个限制。
Cloudflare策略更新： Cloudflare的反爬虫机制会不断更新和演进。当前的解决方案可能在未来因Cloudflare的策略调整而失效。因此，需要持续关注和维护抓取脚本。
等待机制： 在$page->goto()之后，页面可能需要时间来完全加载JavaScript或通过Cloudflare的挑战。在某些情况下，你可能需要使用$page->waitForSelector()等待特定元素出现，或者$page->waitForTimeout()（不推荐作为通用解决方案）来确保页面完全稳定。
CSRF令牌用途： 示例中提取了CSRF令牌。虽然仅仅获取页面内容可能不需要它，但如果你计划进一步模拟用户提交表单或执行其他交互操作，那么这个令牌通常是必不可少的，用于防止跨站请求伪造攻击。
代理与IP轮换： 对于大规模或频繁的抓取任务，结合代理IP轮换可以有效降低被目标网站封禁的风险。Puphpeteer支持配置代理。
伦理与合法性： 在进行网页抓取时，务必遵守目标网站的robots.txt协议，尊重网站的服务条款，并确保数据抓取的行为符合当地法律法规。过度或恶意的抓取可能导致法律风险或IP被封禁。

总结

当传统的PHP抓取方法在面对Cloudflare等高级反爬机制时失效，Puphpeteer提供了一个强大且灵活的解决方案。通过模拟真实浏览器行为并执行JavaScript，Puphpeteer能够有效绕过复杂的验证流程，成功获取目标页面的完整内容。虽然它带来了额外的资源消耗和配置复杂性，但其在处理动态内容和反爬虫挑战方面的能力，使其成为PHP网页抓取工具箱中不可或缺的一部分。掌握Puphpeteer不仅能解决抓取难题，也为PHP开发者打开了浏览器自动化的广阔应用空间。

以上就是使用PHP绕过Cloudflare进行网页抓取：Puphpeteer实战教程的详细内容，更多请关注php中文网其它相关文章！