极验验证码3.0配置教程 2017-06-18 21:12:13

在公司项目中，从未使用过第三方验证码，如极验。在我的博客中，本来是打算使用传统的字符验证码的，不过博客本来就不是什么项目，不存在什么加急维护方面的，为什么不趁机了解一下呢？说不定以后有项目需要极验呢。

通过官方文档(http://docs.geetest.com/install/server/php/)，我们可以得到SDK：https://github.com/GeeTeam/gt3-php-sdk

开始：

首先配置密钥，路径是config/config.php

在SDK的demo中可见(static/login.html)，它以本地形式引用了gt.js，如果希望以公共库形式引入，可以引用https://static.geetest.com/static/tools/gt.js

客户端初始化前，必须要先让服务端初始化一次，不然会报错

$.ajax({ // 获取id，challenge，success（是否启用failback） url: "web/StartCaptchaServlet.php?t=" + (new Date()).getTime(), // 加随机数防止缓存 type: "get", dataType: "json", success: function (data) { initGeetest({ //==固定写法，也是必选参数，无需在意是什么 gt: data.gt, challenge: data.challenge, new_captcha: data.new_captcha, offline: !data.success, //== product: "popup", //产品形式，包括：float，embed，popup。注意只对PC版验证码有效 width: '120px', //宽度 lang: 'zh-cn', //设置验证界面文字的语言。目前可选语言有：zh-cn，en protocol: 'http://' //设置验证涉及到的请求所使用的协议。常见的有 http://，https://。默认值与宿主页面所使用的协议一致。 }, handlerEmbed); } }); //验证码初始化后执行的代码 var handlerEmbed = function(captchaObj){ captchaObj.appendTo("#captcha"); //把验证码生成在id为captcha的元素里 //滑动验证通过 captchaObj.onSuccess(function(){ var validate = captchaObj.getValidate(); //注意：如果业务逻辑要求这行代码放在onSuccess外面，必须要保证客户端验证码滑动验证成功，否者这是个undefined //提交表单 $.ajax({ url: "web/VerifyLoginServlet.php", type: "post", dataType: "json", data: { //==当你正式提交表单的时候，这些是必须要同时提交的 geetest_challenge: validate.geetest_challenge, geetest_validate: validate.geetest_validate, geetest_seccode: validate.geetest_seccode, //== content: "我提交了一个表单" }, success:function (res) { //提交完成后，这里可以做点小动作判断验证码有没有提交成功，当然也能同时判断点什么，例如字符串长度不符合 if (res.state == 0) { alert("提交成功"); } else if (res.state == 1) { alert("验证码错误"); } } }); }); }

接着配置服务端，千万别以为因为它是SDK就不用做什么修改，它留下了很多坑，要我们自己去弥补，而且还要扩展自己的业务逻辑。

首先是config/config.php，为什么要改这个？因为SDK都要引入这个文件，直接在这里改比较方便。

在最后一行添加以下代码

function getIP() { if (getenv('HTTP_CLIENT_IP')) { $ip = getenv('HTTP_CLIENT_IP'); } elseif (getenv('HTTP_X_FORWARDED_FOR')) { $ip = getenv('HTTP_X_FORWARDED_FOR'); } elseif (getenv('HTTP_X_FORWARDED')) { $ip = getenv('HTTP_X_FORWARDED'); } elseif (getenv('HTTP_FORWARDED_FOR')) { $ip = getenv('HTTP_FORWARDED_FOR'); } elseif (getenv('HTTP_FORWARDED')) { $ip = getenv('HTTP_FORWARDED'); } else { $ip = $_SERVER['REMOTE_ADDR']; } return $ip; }

总之只是一种获取客户端IP的方式而已，如果你有更好的，或者已有的方式可以用自己的。

接下来改web/StartCaptchaServlet.php

require_once dirname(dirname(__FILE__)) . '/lib/class.geetestlib.php'; require_once dirname(dirname(__FILE__)) . '/config/config.php'; $GtSdk = new GeetestLib(CAPTCHA_ID, PRIVATE_KEY); session_start(); //获取一个客户端标识，demo只给出一个test，个人不推荐那么做，可以像我这样用uniqid if (!isset($_SESSION['user_id']) || $_SESSION['user_id'] == '') $_SESSION['user_id'] = uniqid(); $data = array( "user_id" => $_SESSION['user_id'], "client_type" => "web", //web:电脑上的浏览器；h5:手机上的浏览器，包括移动应用内完全内置的web_view；native：通过原生SDK植入APP应用的方式 "ip_address" => getIP() //调用刚刚在config/config.php添加的getIP()，获取客户端的IP ); $status = $GtSdk->pre_process($data, 1); $_SESSION['gtserver'] = $status; $_SESSION['user_id'] = $data['user_id']; echo $GtSdk->get_response_str();

最后修改web/VerifyLoginServlet.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); $data = array( "user_id" => $_SESSION['user_id'], "client_type" => "web", //web:电脑上的浏览器；h5:手机上的浏览器，包括移动应用内完全内置的web_view；native：通过原生SDK植入APP应用的方式 "ip_address" => getIP() //调用刚刚在config/config.php添加的getIP()，获取客户端的IP ); if ($_SESSION['gtserver'] == 1) { //服务器正常 $result = $GtSdk->success_validate($_POST['geetest_challenge'], $_POST['geetest_validate'], $_POST['geetest_seccode'], $data); if ($result) { success(); } else{ fail(); } }else{ //服务器宕机,走failback模式 if ($GtSdk->fail_validate($_POST['geetest_challenge'],$_POST['geetest_validate'],$_POST['geetest_seccode'])) { success(); }else{ fail(); } } //验证成功后要做什么 function success() { echo '{"status":0}'; } //失败后又要做什么 function fail() { echo '{"status":1}'; }

后记：因为官方的文档说的内容几乎没有参考价值，本文内容几乎是本人自己领悟的，当时我看官方的文档基本上是这个表情：

本文发布前发现了很多个人倾向的吐槽，自己阅读一遍都感觉很多内容都没有意义，所以把刚写好的草稿删掉了，尽可能以简洁的方式表达自己的经验

如果内容有误，欢迎批评指正

原创文章,转载请注明出处