PHP 极验验证码实例讲解

5年以前 | 阅读数：786 次 | 编程语言：PHP

你能找到这篇文章，说明你对极验验证已经不是完全陌生的了，所有废话我就不多说了，直接开始表说如何使用它，不过在此之前呢，先粘贴几个你可能会用得到的网址：

官网：http://www.geetest.com/

官方文档：http://www.geetest.com/install/sections/idx-basic-introduction.html

github：https://github.com/GeeTeam/gt-php-sdk.git

如何使用：

首先要确认前端使用页面，比如登陆页面

1.在登陆页面访问引入类库：

如果您的网站使用https，则只需要将引入极验库的地方换成https协议即可，不需要更改其它地方。例如更换成以下代码即可：

2.初始化前端

下面的代码需要在页面加载后就执行，如果你使用jQuery，可以写在$(function(){});内


    $.ajax({
      // 获取id，challenge，success（是否启用failback）
      url: "../web/StartCaptchaServlet.php?t=" + (new Date()).getTime(), // 加随机数防止缓存
      type: "get",
      dataType: "json",
      success: function (data) {
        // 使用initGeetest接口
        // 参数1：配置参数
        // 参数2：回调，回调的第一个参数验证码对象，之后可以使用它做appendTo之类的事件
        initGeetest({
          gt: data.gt,
          challenge: data.challenge,
          product: "popup", // 产品形式，包括：float，embed，popup。注意只对PC版验证码有效
          offline: !data.success // 表示用户后台检测极验服务器是否宕机，与SDK配合，用户一般不需要关注
        }, handlerPopup);
      }
    });

上面代码的意思是说，页面加载后，需要到你指定的URL地址上获得验证码信息,至于上面的URL地址"../web/StartCaptchaServlet.php"里面写了什么内容，这个我们在服务器端代码部署会详细说明。

但是需要说明的是，上面的代码里有一个回调函数叫"handlerPopup"，这个函数是你需要验证码的真正初始化代码：如下：


    // 代码详细说明
    var handlerPopup = function (captchaObj) {
      // 注册提交按钮事件，比如在登陆页面的登陆按钮
      $("#popup-submit").click(function () {
        // 此处省略在登陆界面中，获取登陆数据的一些步骤

        // 先校验是否点击了验证码
        var validate = captchaObj.getValidate();
        if (!validate) {
          alert('请先完成验证！');
          return;
        }
        // 提交验证码信息，比如登陆页面，你需要提交登陆信息，用户名和密码等登陆数据
        $.ajax({
          url: "../web/VerifyLoginServlet.php",
          type: "post",
          // dataType: "json",
          data: {
            // 用户名和密码等其他数据，自己获取，不做演示
            username:username,
            password:password,
            // 验证码数据，这些数据不用自己获取
            // 这是二次验证所需的三个值
            // 当然，你也可以直接设置验证码单独校验，省略其他信息
            geetest_challenge: validate.geetest_challenge,
            geetest_validate: validate.geetest_validate,
            geetest_seccode: validate.geetest_seccode
          },
          // 这里是正确返回处理结果的处理函数
          // 假设你就返回了1，2，3
          // 当然，正常情况是返回JSON数据
          success: function (result) {
            // 1表示验证码验证失败
            if (result == "1") {
              alert("验证码验证失败！");
            }else if (result == "2") {
              alert("用户名或密码错误！");
            }else if (result == "3") {
              alert("登陆成功！");
              // 登陆成功了，可以在这里做其他处理
            }else{
              alert("登陆错误！");
            }
          }
        });
      });
      // 弹出式需要绑定触发验证码弹出按钮
      // 比如在登陆页面，这个触发按钮就是登陆按钮
      captchaObj.bindOn("#popup-submit");

      // 将验证码加到id为captcha的元素里
      // 验证码将会在下面指定的元素中显示出来
      captchaObj.appendTo("#popup-captcha");

      // 更多接口参考：http://www.geetest.com/install/sections/idx-client-sdk.html
    };

至此，前端的所有设置都写完了，官方的说明文档：http://www.geetest.com/install/sections/idx-client-sdk.html

3.服务器端部署（PHP）

在第一步中，我们设置了一个这样的地址"../web/StartCaptchaServlet.php"，在这个地址里边写什么呢：


    <?php
    // 引入文件
    require_once dirname(dirname(__FILE__)) . '/lib/class.geetestlib.php';
    require_once dirname(dirname(__FILE__)) . '/config/config.php';
    // 实例化，实例化的参数在config中配置，分别是：验证ID 和 验证Key，如何获取下面会说。
    $GtSdk = new GeetestLib(CAPTCHA_ID, PRIVATE_KEY);
    session_start();
    // 这个是用户的标识，或者说是给极验服务器区分的标识，如果你项目没有预先设置，可以像下面这样设置：
    if(!isset($_SESSION['user_id'])){
      $_SESSION['user_id']=uniqid();// 生成一个唯一ID
    }
    $user_id = $_SESSION['user_id'];
    // 或者，你就直接写成：
    // $user_id = "test";

    // 生成验证码信息，并返回给客户端
    $status = $GtSdk->pre_process($user_id);
    $_SESSION['gtserver'] = $status;
    $_SESSION['user_id'] = $user_id;
    echo $GtSdk->get_response_str();
    ?>

如何获取验证ID 和验证Key ：

1.从验证后台注册账号
2.添加验证，可以获取一组当前验证的ID/Key
3.将ID和Key分别替换到config.php文件中的captcha_id/private_key变量的值　

4.点击提交按钮之后的服务端校验（二次验证）

比如上面说的，用户登录时，你把用户名和密码和验证码信息都提交到服务器了，这个时候，你就可以做校验了：


    <?php
    // 引入文件
    require_once dirname(dirname(__FILE__)) . '/lib/class.geetestlib.php';
    require_once dirname(dirname(__FILE__)) . '/config/config.php';
    session_start();
    $GtSdk = new GeetestLib(CAPTCHA_ID, PRIVATE_KEY);

    // 比如你设置了一个验证码是否验证通过的标识
    $code_flag=false;

    // 这里获取你之前设置的user_id，传送给极验服务器做校验
    $user_id = $_SESSION['user_id'];
    if ($_SESSION['gtserver'] == 1) {
      $result = $GtSdk->success_validate($_POST['geetest_challenge'], $_POST['geetest_validate'], $_POST['geetest_seccode'], $user_id);
      if ($result) {
        // 验证码验证成功
        $code_flag=true;
      }
    }else{
      if ($GtSdk->fail_validate($_POST['geetest_challenge'],$_POST['geetest_validate'],$_POST['geetest_seccode'])) {
         // 验证码验证成功
        $code_flag=true;
      }
    }

    // 如果验证码验证成功，再进行其他校验
    if($code_flag){
      // 其他验证操作
      // 用户名不对时，返回2，其他错误返回3，等等。。。。
    }else{
      // 验证码验证失败，返回1，这里和上面相呼应，当然我的项目没有简单的返回1，而是返回了JSON数据
      echo 1;
      exit(-1);
    }
    ?>

感谢你的阅读，希望能帮助到大家，谢谢大家对本站的支持！