README

这是yii2框架的Js验证码，所有的使用方式与系统自带的yii\captcha\Captcha一致。

本代码主要使用极验的服务，并进行yii2封装，使得所有的代码开放极为简单！感谢极验团队提供的免费服务，同时也欢迎购买其付费服务！

安装

推荐的方式是通过composer进行下载安装composer。

composer require lengnuan-v/yii2-geetest:"@dev" 

将以下代码添加到您的composer.json文件的require部分。

使用

1. 在配置文件中（如common/config/main.php）添加以下代码：

return [
    'components' => [
        'geetest' => [
            'class' => 'lengnuan\captcha\Geetest',
            'gtId' => '极验的ID'
            'gtKey' => '极验的Key',
            ],
        ],
    ]
];

1. 在LoginForm中添加captcha的rules，LoginForm的示例可能如下：

class LoginForm extends Model
{
    public $phone;
    public $smsCaptcha;
    public $captcha;
    public $rememberMe = true;

    // ...其它代码

    public rules()
    {
        return [
            // 该规则类似于\yii\captcha\CaptchaValidator,会将post过来的数据自动去极验后台校验
            ['captcha', '\lengnuan\captcha\GtCaptchaValidator'],
            // ...其它规则
        ],
    }

    public function login()
    {
        //具体登录代码...
    }

    public function sendSms()
    {
        //具体发送验证码代码...
    }
}

3.在前端页面（如login.php）上添加captcha的展示

    use lengnuan\captcha\GtCaptcha;
    <?=  GtCaptcha::widget([
        'onSuccess' => 'function(result){
            sendSms(); // js验证码成功时的动作，本例中为js发出短信验证码
        }',
        'type' => GtCaptcha::TYPE_BIND, //type为绑定，意思为当点击id为bindTo配置(即sendsms)时，调出极验验证框
        'bindTo' => 'sendsms',
        'name' => 'LoginForm[captcha]', // input的name
        'gtOptions' => [                //gt的显示option
             'width' => '50%',
        ],
    ]);?>

如上即为示例中的widget的展示

4.编写相应的controller，该内容与本包无关，但是需要调用相应LoginForm的validate()方法。

经过上述配置后，你会发现，当你点击按钮时，会直接触发js校验，前后端校验均已完成！