PHP服务器禁用Socket时通过Curl实现reCAPTCHA验证

背景与解决方案概述

早期版本的reCAPTCHA（如v1及基础版v2）官方提供的PHP类库 recaptchalib.php 默认依赖原生的Socket函数来构建POST请求。许多共享主机出于安全考虑会禁用 fsockopen 或 pfsockopen，这会导致验证失败。利用PHP内置的 cURL 扩展替代Socket是解决此问题的标准方法，因为大多数支持PHP的主机都默认开启了cURL。

准备工作

1. 获取API密钥：前往 Google reCAPTCHA管理后台（注：旧版控制台地址可能已迁移至Google Cloud Console），申请网站的公钥（Public Key）和私钥（Private Key）。
2. 下载类库：获取原始的 recaptchalib.php 文件。
3. 确认环境：通过 phpinfo() 确认服务器已启用 curl 扩展。

第一步：替换核心通信函数

打开 recaptchalib.php，找到负责网络请求的内部函数 _recaptcha_http_post 以及验证主函数 recaptcha_check_answer。需要将前者从Socket模式改写为cURL模式。

1. 修改 _recaptcha_http_post 函数

该函数负责构造HTTP POST请求。请用以下代码替换原有的Socket实现：

function _recaptcha_http_post($host, $path, $data, $port = 80) {
    $req = _recaptcha_qsencode($data);
    $response = '';
    $url = "http://$host$path"; // 显式添加协议头，避免某些环境解析错误
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $req);
    // 设置超时时间，防止请求挂起
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    
    $output = curl_exec($ch);
    
    if(curl_errno($ch)){
        return false; // 如果cURL报错，返回false以便上层处理
    }
    
    curl_close($ch);
    $response = $output;
    return $response;
}

注意：原代码中可能存在对数组格式的处理差异，请确保传递的 $data 已被 _recaptcha_qsencode 正确编码为查询字符串格式。

2. 完善 recaptcha_check_answer 逻辑

在旧版库中，验证结果的解析有时不够健壮。建议在调用完 _recaptcha_http_post 后，增加对返回值的完整性检查：

function recaptcha_check_answer ($privkey, $remoteip, $challenge, $response, $extra_params = array()) {
    if ($privkey == null || $privkey == '') {
        die('To use reCAPTCHA you must get an API key from https://www.google.com/recaptcha/admin/create');
    }
    if ($remoteip == null || $remoteip == '') {
        die('For security reasons, you must pass the remote ip to reCAPTCHA');
    }

    // 丢弃空提交
    if ($challenge == null || strlen($challenge) == 0 || $response == null || strlen($response) == 0) {
        $recaptcha_response = new ReCaptchaResponse();
        $recaptcha_response->is_valid = false;
        $recaptcha_response->error = 'incorrect-captcha-sol';
        return $recaptcha_response;
    }

    // 调用新的cURL方法
    $result = _recaptcha_http_post(RECAPTCHA_VERIFY_SERVER, "/recaptcha/api/verify",
        array (
            'privatekey' => $privkey,
            'remoteip' => $remoteip,
            'challenge' => $challenge,
            'response' => $response
        ) + $extra_params
    );

    // 如果网络请求失败
    if ($result === false) {
        $recaptcha_response = new ReCaptchaResponse();
        $recaptcha_response->is_valid = false;
        $recaptcha_response->error = 'failed-curl-request';
        return $recaptcha_response;
    }

    $answers = explode("\n", $result);
    $recaptcha_response = new ReCaptchaResponse();

    // 检查第一行是否为 true
    if ($answers[0] === 'true') {
        $recaptcha_response->is_valid = true;
    } else {
        $recaptcha_response->is_valid = false;
        // 提取错误信息，通常位于第二行
        $recaptcha_response->error = isset($answers[1]) ? $answers[1] : 'unknown-error';
    }
    return $recaptcha_response;
}

第二步：创建前端验证Demo

创建一个名为 demo.php 的文件，用于测试上述修改是否生效。请将你的密钥填入相应变量。

<?php
require_once('recaptchalib.php');

// 替换为你的实际密钥
$publickey = "YOUR_PUBLIC_KEY_HERE";
$privatekey = "YOUR_PRIVATE_KEY_HERE";

$resp = null;
$error = null;

// 判断是否为POST提交
if ($_SERVER["REQUEST_METHOD"] == "POST") {
    // 兼容旧版字段名，新版API推荐使用 g-recaptcha-response
    $challenge_field = isset($_POST['recaptcha_challenge_field']) ? $_POST['recaptcha_challenge_field'] : '';
    $response_field = isset($_POST['recaptcha_response_field']) ? $_POST['recaptcha_response_field'] : (isset($_POST['g-recaptcha-response']) ? $_POST['g-recaptcha-response'] : '');

    if (!empty($response_field)) {
        $resp = recaptcha_check_answer(
            $privatekey,
            $_SERVER["REMOTE_ADDR"],
            $challenge_field,
            $response_field
        );
    }

    if ($resp->is_valid) {
        echo "<div style='color:green;'>验证成功！</div>";
    } else {
        $error = $resp->error;
        echo "<div style='color:red;'>验证失败：" . htmlspecialchars($error) . "</div>";
    }
}

// 生成HTML验证码
// 如果是旧版库，可能需要手动拼接html或使用 recaptcha_get_html
$html = recaptcha_get_html($publickey, $error);
echo $html;
?>

<html>
<body>
    <form action=\"" . $_SERVER['PHP_SELF'] . "\" method=\"POST\">
        <!-- 这里放置 recaptcha_get_html 输出的内容 -->
        <br />
        <input type=\"submit\" value=\"Submit\" />
    </form>
</body>
</html>

完成判断与排错

部署完成后，访问 demo.php 页面。若能正常显示验证码图片及输入框，且在勾选并提交后，根据验证结果输出“成功”或具体的错误代码（而非致命的PHP警告或空白页），即表示cURL集成成功。

• 常见错误：若返回 “failed-curl-request”，请检查服务器防火墙是否允许 outgoing connections 到 Google 服务器，或者 CURLOPT_TIMEOUT 设置过短。
• SSL证书问题：在新版Google API中，必须使用HTTPS。若您的服务器无法验证SSL证书，可在 curl_setopt 中添加 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);（不推荐生产环境使用，仅用于调试内部网络）。

简要总结

通过替换 _recaptcha_http_post 函数中的Socket调用来实现基于cURL的请求，可有效解决虚拟主机禁用Socket导致的reCAPTCHA验证失效问题。此方法保留了原有类库的逻辑结构，只需局部修改即可适配受限环境。以上就是PHP空间不支持Socket但支持Curl时recaptcha的用法的详细内容，更多关于PHP验证码集成的资料请关注本站其它相关文章！