README

CapSolver captcha 解析服务的简单客户端。

• 安装
  • Composer
• 配置
• 解析 captcha
  • ReCaptcha v3
  • ReCaptcha v2
• 错误处理

安装

本包可以通过 composer 安装。

Composer

composer require greezlu/capsolver-php

配置

创建 CapsolverClient 实例的方式如下

$solver = new \Capsolver\CapsolverClient('YOUR_API_KEY');

解析 captcha

更多关于请求和响应的信息，请参阅相关文档页面。

ReCaptcha v3

更多详情请查看 文档。

请求

$solution = $solver->recaptchaV3(
    \Capsolver\Solvers\Token\ReCaptchaV3::TASK,
    [
      'websiteURL'    => 'https://www.google.com/recaptcha/api2/demo',
      'websiteKey'    => '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
      'pageAction'    => 'verify',
      'minScore'      => 0.6,
      'proxy'         => 'http:ip:port:user:pass'
    ]
);

响应

$solution = [
    'userAgent' => 'xxx',
    'expireTime' => 1671615324290,
    'gRecaptchaResponse' => '3AHJ.....'
];

ReCaptcha v2

更多详情请查看 文档。

请求

$solution = $solver->recaptchaV2(
    \Capsolver\Solvers\Token\ReCaptchaV2::TASK,
    [
      'websiteURL'    => 'https://www.google.com/recaptcha/api2/demo',
      'websiteKey'    => '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
      'proxy'         => 'http:ip:port:user:pass'
    ]
);

响应

$solution = [
    'userAgent' => 'xxx',
    'expireTime' => 1671615324290,
    'gRecaptchaResponse' => '3AHJ.....'
];

错误处理

如果解析器出现错误，会抛出一个 CapsolverException 异常实例。

try {
    $solution = $solver->recaptchaV3('', []);
} catch (\Capsolver\Exceptions\RequestException $error) {
    // Error happened before api request
} catch (\Capsolver\Exceptions\ResponseException $error) {
    // Error happened after api request
} catch (\Capsolver\Exceptions\CapsolverException $error) {
    // General error
}