Zend框架下从reCaptcha迁移至reCaptcha2的改造方案咨询

嘿，我帮你梳理下Zend Framework 1.x升级到reCaptcha v2（就是那个"我不是机器人"的复选框）需要改的地方——毕竟原生的Zend_Service_ReCaptcha和表单元素只支持reCaptcha v1，得从前端渲染和后端验证两个核心部分调整，具体修改步骤如下：

1. 替换后端验证逻辑 #

原来的Zend_Service_ReCaptcha完全不兼容v2的验证机制，我们需要直接调用Google的v2验证API来校验用户提交的响应：

步骤1.1：移除旧的ReCaptcha服务初始化 #

直接删掉这行代码，因为v2不再需要这个服务实例：

$reCaptcha = new Zend_Service_ReCaptcha($config->recaptcha->site_key, $config->recaptcha->secret_key);

步骤1.2：重构表单的验证码元素 #

原来的Zend_Form_Element_Captcha用的是v1适配器，我们提供两种修改方案：

快速实现版（适合小范围改动）

用隐藏域+自定义验证器的组合替换原有的验证码元素：

// 添加隐藏域，用来接收reCaptcha返回的响应值
$captchaResponse = new Zend_Form_Element_Hidden('g-recaptcha-response');
$captchaResponse->setRequired(true)
                ->addValidator('Callback', true, array(
                    'callback' => function($value) use ($config, $translator) {
                        // 调用Google的v2验证API
                        $httpClient = new Zend_Http_Client('https://www.google.com/recaptcha/api/siteverify');
                        $httpClient->setParameterPost([
                            'secret'   => $config->recaptcha->secret_key,
                            'response' => $value,
                            'remoteip' => $_SERVER['REMOTE_ADDR'] // 可选，但推荐传用户IP提升验证精度
                        ]);
                        
                        $apiResponse = $httpClient->request(Zend_Http_Client::POST);
                        $verificationResult = Zend_Json::decode($apiResponse->getBody());
                        
                        if (!$verificationResult['success']) {
                            // 可根据error-codes返回更具体提示，比如超时、无效密钥等
                            throw new Zend_Validate_Exception($translator->translate('Form-Captcha-InvalidCa...'));
                        }
                        return true;
                    },
                    'messages' => [
                        Zend_Validate_Callback::INVALID_VALUE => $translator->translate('Form-Captcha-InvalidCa...')
                    ]
                ));

// 把这个元素加入表单
$this->addElement($captchaResponse);

// 删除原来的$captcha元素，在表单视图/装饰器里手动渲染v2控件：
// <div class="g-recaptcha" data-sitekey="<?php echo $this->escape($config->recaptcha->site_key); ?>"></div>

2. 前端引入reCaptcha v2脚本 #

在页面的<head>或表单所在视图文件里，加入Google的reCaptcha脚本：

<script src="https://www.google.com/recaptcha/api.js" async defer></script>

3. 优雅方案：封装自定义Captcha适配器 #

如果想保持原有表单代码风格，建议封装自定义适配器，继续用Zend_Form_Element_Captcha的方式：

第一步：创建自定义适配器类 #

class My_Captcha_ReCaptchaV2 extends Zend_Captcha_Adapter_Abstract
{
    protected $_secretKey;
    protected $_siteKey;

    public function __construct($options = null)
    {
        if (is_array($options)) {
            $this->setOptions($options);
        }
    }

    // 密钥配置的setter/getter
    public function setSecretKey($key)
    {
        $this->_secretKey = $key;
        return $this;
    }

    public function getSecretKey()
    {
        return $this->_secretKey;
    }

    public function setSiteKey($key)
    {
        $this->_siteKey = $key;
        return $this;
    }

    public function getSiteKey()
    {
        return $this->_siteKey;
    }

    // v2不需要生成验证码字符串，返回空即可
    public function generate()
    {
        return '';
    }

    // 核心验证逻辑
    public function isValid($value, $context = null)
    {
        if (!isset($context['g-recaptcha-response']) || empty($context['g-recaptcha-response'])) {
            $this->_error(self::MISSING_VALUE);
            return false;
        }

        $httpClient = new Zend_Http_Client('https://www.google.com/recaptcha/api/siteverify');
        $httpClient->setParameterPost([
            'secret'   => $this->_secretKey,
            'response' => $context['g-recaptcha-response'],
            'remoteip' => $_SERVER['REMOTE_ADDR']
        ]);
        
        $apiResponse = $httpClient->request(Zend_Http_Client::POST);
        $verificationResult = Zend_Json::decode($apiResponse->getBody());

        if (!$verificationResult['success']) {
            $this->_error(self::BAD_CAPTCHA);
            return false;
        }

        return true;
    }

    // 渲染v2验证码控件
    public function render(Zend_View_Interface $view = null)
    {
        return '<div class="g-recaptcha" data-sitekey="' . $view->escape($this->_siteKey) . '"></div>';
    }
}

第二步：在表单里使用自定义适配器 #

$captcha = new Zend_Form_Element_Captcha('captcha', array(
    'captcha' => array(
        'captcha' => 'ReCaptchaV2', // Zend会自动匹配前缀My_Captcha_ReCaptchaV2
        'secretKey' => $config->recaptcha->secret_key,
        'siteKey' => $config->recaptcha->site_key,
        'messages' => array(
            'badCaptcha' => $translator->translate('Form-Captcha-InvalidCa...')
        )
    )
));

$this->addElement($captcha);

这种方式和你原来的代码结构几乎一致，只是更换了适配器，更易维护。

内容的提问来源于stack exchange，提问作者fractal5