PHP में hCaptcha: CapSkip SDK और Guzzle से हल करें

hcaptcha in php - hCaptcha in PHP: Solve It With the CapSkip SDK and Guzzle

PHP में hCaptcha हल करने के लिए capskip/capskip इंस्टॉल करें और sitekey तथा पेज के पते के साथ hcaptcha() call करें। CapSkip hCaptcha सॉल्वर एक token और वह User-Agent लौटाता है जिसके साथ वह मिला। PHP वाला हिस्सा घड़ी है: CapSkip के दस्तावेज़ों के अनुसार एक हल में 10 से 30 सेकंड लगते हैं, timeout न देने पर SDK 300 तक इंतज़ार करता है, और PHP एक वेब रिक्वेस्ट को 30 के बाद खत्म कर देता है। यह गाइड timeout को उस सीमा के भीतर बैठाती है, फिर Guzzle से फ़ॉर्म post करती है।

आपको क्या चाहिए

  • CapSkip 4.0.0 या बाद वाली Windows मशीन, जो hCaptcha संभालने वाला पहला वर्ज़न है।
  • Composer और PHP 8.0.2 या बाद का, curl और json extensions चालू करके। SDK 8.0 माँगता है, और 8.0.30 पर SDK और Guzzle के लिए Composer की platform check 8.0.2 बताती है। hcaptcha method SDK वर्ज़न 1.6.0 में आया। मैंने Windows के लिए PHP 8.0.30, 8.1.33, 8.2.29, 8.3.28, 8.4.15 और 8.5.0 चलाए, हर एक Guzzle 7.16.1 और Guzzle 8.3.0 दोनों के साथ।
  • hCaptcha widget से सुरक्षित ऐसा फ़ॉर्म जिसे ऑटोमेट करने की आपको अनुमति हो, और widget का sitekey।
  • CapSkip तक पहुँचने का एक रास्ता। Local mode सिर्फ़ उसी PC पर जवाब देता है जिस पर वह चलता है (127.0.0.1)। Server mode आपके नेटवर्क या पब्लिक IP पर भी जवाब देता है। कनेक्शन सेटिंग्स में आप मोड चुनते हैं।
# In a PowerShell prompt, in the folder that will hold hcaptcha_form.php
composer require capskip/capskip guzzlehttp/guzzle

यह कैसे टेस्ट किया गया: in.php और res.php के उस mock के सामने जिसे मैंने API दस्तावेज़ के hCaptcha सेक्शन को देखकर लिखा था, उसके बगल में एक नकली sign-up पेज के साथ। कोई रिक्वेस्ट असली CapSkip app या hCaptcha साइट तक नहीं गई, इसलिए नीचे का हर हल का समय एक mock सेटिंग है और पेज की जाँचें (हर token एक बार, मेल खाता User-Agent, दो मिनट की वैधता) दस्तावेज़ों के नियम हैं जैसे मैंने उन्हें कोड किया। PHP वाला हिस्सा असली है: SDK, Guzzle और Windows पर PHP, command line पर और built-in web server के तहत, Apache या IIS पर नहीं। hCaptcha के डेवलपर दस्तावेज़ असली verification के बारे में बताते हैं।

चरण 1: अपने timeout के साथ hcaptcha() call करें

चारों PHP ब्लॉक को hcaptcha_form.php नाम की एक फ़ाइल में, दिखाए गए क्रम में रखें। sitekey h-captcha container पर data-sitekey attribute, hcaptcha.render() का sitekey option, या widget के iframe पते का sitekey= parameter होता है। उसे SITEKEY में चिपकाएँ और PAGE_URL सेट करें।

method hcaptcha(string $sitekey, string $url, array $options = []) है। options array ये keys लेता है: "timeout", "invisible" (1 या true), "data" (Enterprise साइट का rqdata मान), "userAgent" और "proxy"। कुछ भी भेजने से पहले SDK खाली sitekey, ऐसा पेज पता जो absolute http या https नहीं है, 0, 1, true या false के अलावा invisible मान, और CapSkip जो कोई option नहीं लेता उसे ठुकरा देता है, जिनमें 2Captcha का domain option भी है। हर इनकार एक ValidationException है।

लौटने वाले array में h-captcha-response और g-recaptcha-response के लिए "token" entry, उसी string वाली "code" entry, एक "userAgent" entry और एक "captchaId" entry होती है। उसकी "respKey" entry hCaptcha का दूसरा मान है, जो कुछ न होने पर खाली रहता है, और ज़्यादातर साइटें उसे कभी नहीं पढ़तीं। task_options function वह जगह है जहाँ invisible या data keys जाती हैं, और वह हर टास्क के लिए चलती है, क्योंकि rqdata का मान एक बार ही इस्तेमाल होता है। API Key Validation चालू होने पर constructor array में एक "apiKey" key जोड़ें।

<?php
// hcaptcha_form.php: run it with php hcaptcha_form.php
declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use CapSkip\CapSkip;
use CapSkip\Exceptions\ApiException;
use CapSkip\Exceptions\CapSkipError;
use CapSkip\Exceptions\TimeoutException;
use GuzzleHttp\Client;
use GuzzleHttp\Cookie\CookieJar;

const PAGE_URL = 'https://example.com/signup';  // the page that shows the widget
const SITEKEY = 'YOUR_SITEKEY';  // the data-sitekey of its h-captcha div
const BUDGET = 90;  // seconds one sign-up may spend waiting for tokens

// Local mode. In Server mode, use your server's address instead. With API Key
// Validation on, add 'apiKey' => 'YOUR_KEY' to this array.
$solver = new CapSkip(['host' => '127.0.0.1', 'port' => 8080]);

// Extra task options, asked for on every task, so a fresh value fits here.
//   invisible widget:  return ['invisible' => 1];
//   Enterprise rqdata: return ['data' => fetch_rqdata()];  (your own function)
function task_options(): array
{
    return [];
}

function solve(CapSkip $solver, float $deadline): array
{
    $left = (int) floor($deadline - microtime(true));
    if ($left < 10) {
        // Not enough time for a solve. A timeout of 0 would mean the SDK default.
        throw new TimeoutException('the budget is used up');
    }
    // Waits for the token. The result holds token (for h-captcha-response and
    // g-recaptcha-response), code (the same string), userAgent (the browser
    // identity of the token), respKey (empty when there is none) and captchaId.
    return $solver->hcaptcha(SITEKEY, PAGE_URL, ['timeout' => $left] + task_options());
}

चरण 2: इंतज़ार को PHP की time limit के भीतर रखें

hcaptcha() call blocking है। वह टास्क सबमिट करता है, फिर token तैयार होने या timeout खत्म होने तक poll करता है। एक वेब रिक्वेस्ट को max_execution_time के 30 सेकंड मिलते हैं, पर command line को कोई सीमा नहीं मिलती: php.ini में 30 होने पर भी यहाँ उसकी सीमा 0 पढ़ी गई, जबकि PHP के built-in web server ने 30 पढ़ा। मैंने Windows पर 5 सेकंड की सीमा इस्तेमाल की, और PHP 8.0.30, 8.4.15 और 8.5.0 ने एक जैसा व्यवहार किया।

5 सेकंड की सीमा के तहत मैंने क्या चलायाक्या हुआ
10 सेकंड की एक अकेली sleepfatal error 10.0 सेकंड पर आया, जब sleep लौटी
0.25 सेकंड के चरणों में sleepfatal error 5.2 सेकंड पर आया
ऐसे टास्क पर hcaptcha() call जो कभी पूरा नहीं हुआfatal error 7.8 सेकंड पर आया, जब SDK की 3.8 से 7.8 सेकंड वाली sleep लौटी
sleep के चारों ओर catch और finally वाला try ब्लॉकदोनों में से कोई नहीं चला। register_shutdown_function की एक function चली, और error_get_last में संदेश था
3 सेकंड बाद set_time_limit(5), फिर 4 सेकंड की sleepकोई error नहीं। script कुल 7.0 सेकंड चली
2 सेकंड बाद set_time_limit(0), 3 सेकंड की सीमा के साथ, फिर 5 सेकंड की sleepकोई error नहीं। script कुल 7.0 सेकंड चली

तीन नियम निकलते हैं। PHP कभी किसी sleep या cURL call को बीच में नहीं रोकता, और SDK इंतज़ार के दौरान बस यही करता है। वह सीमा तब जाँचता है जब control लौटता है, इसलिए एक इंतज़ार अपनी पूरी लंबाई जितना overshoot कर सकता है। fatal error catch और finally को छोड़ देता है, इसलिए आपका कोई handler काम नहीं बचा सकता। और set_time_limit काउंटर में जोड़ने के बजाय उसे फिर से शुरू करता है। मैंने सिर्फ़ Windows पर चलाया, और set_time_limit का PHP मैनुअल कहता है कि दूसरे सिस्टम sleep या socket पर इंतज़ार को नहीं गिनते।

बाकी SDK की polling तय करती है, जैसा उसके source में पढ़ा और mock के सामने जाँचा गया। पहला poll तुरंत जाता है, फिर वह 0.25 सेकंड सोता है, 0.5, 1, 2 और 4, और उसके बाद polls के बीच 5। timeout poll शुरू करने की deadline है, जवाब की नहीं। 20 के timeout पर आख़िरी poll 17.8 सेकंड पर गया और TimeoutException 22.9 पर आया, इसलिए जो token 19 सेकंड पर तैयार हुआ वह कभी पढ़ा ही नहीं गया। 0 का timeout SDK के 120 सेकंड वाले defaultTimeout पर लौट जाता है, जिसे solve function टालती है।

इसलिए BUDGET वह अकेली संख्या है जो आपकी है: एक sign-up tokens के लिए कितना इंतज़ार कर सकता है, सभी कोशिशों में साझा। चरण 4 PHP को BUDGET के साथ 30 सेकंड और देता है, ताकि आपकी deadline पहले चले, एक ऐसे TimeoutException के रूप में जिसे आप पकड़ सकते हैं, कभी ऐसे fatal error के रूप में नहीं जिसे आप नहीं पकड़ सकते। BUDGET को PHP के आगे लगे किसी भी web server timeout से कम रखें, जिसे set_time_limit नहीं छूता। CapSkip किसी टास्क को खाली hCaptcha thread के लिए भी रोक सकता है, जो मेरे पढ़े app source में 250 सेकंड तक है, इसलिए बहुत सारे हल कतार में हों तो BUDGET को PHP की सीमा के साथ बढ़ाएँ।

चरण 3: cookie jar और सही User-Agent के साथ फ़ॉर्म post करें

पेज लोड और post को एक ही विज़िटर जैसा दिखना चाहिए। Guzzle client तब तक कोई cookies नहीं रखता जब तक आप उसे jar न दें, इसलिए post_form एक नए CookieJar वाला client बनाता है, पेज लोड करता है और पेज की सेट की हुई cookies के साथ post करता है।

token एक ब्राउज़र पहचान से भी जुड़ा है। दस्तावेज़ कहते हैं कि जवाब उस User-Agent का नाम देता है जिससे CapSkip ने हल किया, और फ़ॉर्म उसी के तहत post होना चाहिए। Guzzle इसके बजाय अपना परिचय देगा: हेडर छोड़ने पर mock ने पेज लोड पर GuzzleHttp/8 (Guzzle 7 में GuzzleHttp/7) देखा, और post ठुकरा दिया। साइट client पर एक डिफ़ॉल्ट User-Agent दोनों रिक्वेस्ट को कवर करता है, इसलिए वह client हल के बाद बनाया जाता है। "userAgent" key इसे नहीं बदलती, क्योंकि दस्तावेज़ कहते हैं कि CapSkip उसका इस्तेमाल तभी करता है जब वह उसके अपने ब्राउज़र से मेल खाए।

post पेज के पते को Referer के रूप में भेजता है। Guzzle कोई नहीं जोड़ता, और कुछ frameworks, उनमें Django भी, बिना Referer और Origin वाले HTTPS form post को ठुकरा देते हैं। इस नियम वाली एक mock साइट ने तब तक 403 दिया जब तक header नहीं जुड़ा। hidden_fields function फ़ॉर्म के hidden inputs कॉपी करती है, जिनमें से एक CSRF token है। उसका loadHTML prefix libxml से UTF-8 पढ़वाता है: उसके बिना, जिस पेज में meta charset tag नहीं है, उस पर hidden मान में एक accented अक्षर बिगड़कर पहुँचा और mock ने post ठुकरा दिया। widget h-captcha-response और g-recaptcha-response दोनों भरता है, इसलिए कोड दोनों भेजता है।

function hidden_fields(string $html): array
{
    $doc = new DOMDocument();
    libxml_use_internal_errors(true);
    // The prefix makes libxml read the page as UTF-8 even without a meta tag.
    $doc->loadHTML('<?xml encoding="UTF-8">' . $html);
    $fields = [];
    foreach ((new DOMXPath($doc))->query('//form//input[@type="hidden"][@name]') as $input) {
        $fields[$input->getAttribute('name')] = $input->getAttribute('value');
    }
    return $fields;
}

function post_form(array $solved, string $email): int
{
    // The SDK adds userAgent only when CapSkip's reply names one. Never fall
    // back to Guzzle's own: the token belongs to the browser that earned it.
    $userAgent = $solved['userAgent'] ?? throw new RuntimeException('CapSkip named no User-Agent');
    // One client for the page load and the post: its jar keeps the session
    // cookie, and its default header is the User-Agent the token was earned with.
    $site = new Client([
        'cookies' => new CookieJar(),
        'headers' => ['User-Agent' => $userAgent],
        'http_errors' => false,
        'timeout' => 20,
    ]);
    $page = $site->get(PAGE_URL);
    if ($page->getStatusCode() !== 200) {
        throw new RuntimeException('GET ' . PAGE_URL . ' answered ' . $page->getStatusCode());
    }
    $fields = hidden_fields((string) $page->getBody());  // the csrf field, for one
    $fields['email'] = $email;  // your form's own fields go here
    $fields['h-captcha-response'] = $solved['token'];
    $fields['g-recaptcha-response'] = $solved['token'];  // the widget fills both
    // Post to the form's action address; here that is the page itself.
    return $site->post(PAGE_URL, [
        'form_params' => $fields,
        'headers' => ['Referer' => PAGE_URL],
    ])->getStatusCode();
}

चरण 4: retries के साथ sign up करें, फिर इसे चलाएँ

sign_up function सबसे पहले समय सँभालती है। अगर PHP की कोई सीमा है और set_time_limit मौजूद है, तो वह घड़ी को BUDGET के साथ 30 सेकंड और पर दोबारा शुरू करती है, SDK की आख़िरी sleep और form post के लिए जगह। command line पर, जहाँ सीमा 0 है, वह कुछ नहीं बदलती। बाद की कोशिश तभी शुरू होती है जब budget के 10 सेकंड बचे हों। आख़िरी ब्लॉक exit चुनता है: समय खत्म होने पर 2, किसी और नाकामी पर 1, और वेब पेज के लिए 504 या 502 status। वह CapSkipError और RuntimeException को साथ-साथ पकड़ता है, क्योंकि SDK के सारे exceptions CapSkipError को extend करते हैं, जो RuntimeException नहीं है।

कुछ hosts set_time_limit को बंद कर देते हैं, और तब fatal error वापस आ जाता है। 30 सेकंड की सीमा और BUDGET 90 पर छोड़ने के साथ वह करीब 33 सेकंड पर आया, SDK के करीब 28 सेकंड वाले poll के बाद की sleep के भीतर। BUDGET 29 भी उसी तरह फेल हुआ, जबकि 25 करीब 28 सेकंड पर TimeoutException के साथ खत्म हुआ। इस call के बिना BUDGET को सीमा से कम से कम 10 सेकंड कम रखें।

सिर्फ़ ERROR_CAPTCHA_UNSOLVABLE नया टास्क पाता है। दस्तावेज़ ERROR_RECAPTCHA_INVALID_SITEKEY और ERROR_PROXY_CONNECT_REFUSED को अलग से बताते हैं क्योंकि दोबारा भेजा गया टास्क उसी तरह फेल होगा, इसलिए वे script को रोक देते हैं। SDK CapSkip के जवाब का text ApiException के संदेश में रखता है, और app का source JSON error को status 0 वाले object के रूप में बनाता है जिसमें code request में होता है, इसलिए code संदेश को str_contains से खोजता है। जब साइट post ठुकराती है, तो loop नया token माँगता है, क्योंकि token एक बार काम करता है। 400 से नीचे का status बस इतना बताता है कि साइट ने रिक्वेस्ट नहीं ठुकराई, इसलिए ऐसे text की भी जाँच करें जो सिर्फ़ सफलता में दिखे।

function sign_up(CapSkip $solver, string $email): int
{
    $deadline = microtime(true) + BUDGET;
    // A limit of 0 means none, as on the command line. Otherwise restart PHP's
    // clock with room to spare, so the SDK's TimeoutException fires first, not
    // PHP's fatal error. Some hosts disable set_time_limit; then keep BUDGET
    // at least 10 seconds under the limit instead.
    if ((int) ini_get('max_execution_time') !== 0 && function_exists('set_time_limit')) {
        set_time_limit(BUDGET + 30);
    }
    for ($attempt = 1; $attempt <= 3; $attempt++) {
        try {
            $solved = solve($solver, $deadline);
        } catch (ApiException $e) {
            if (!str_contains($e->getMessage(), 'ERROR_CAPTCHA_UNSOLVABLE')) {
                throw $e;  // a refused sitekey or an unreachable proxy would fail again
            }
            error_log("attempt $attempt: ERROR_CAPTCHA_UNSOLVABLE, new task");
            continue;
        }
        $status = post_form($solved, $email);
        if ($status < 400) {
            return $status;
        }
        error_log("attempt $attempt: the site answered $status, new token");
    }
    throw new RuntimeException('no accepted form after 3 attempts');
}
try {
    $status = sign_up($solver, '[email protected]');
    echo "the site answered $status\n";
} catch (TimeoutException $e) {
    if (!headers_sent()) {
        http_response_code(504);  // no effect on the command line
    }
    echo 'out of time: ', $e->getMessage(), "\n";
    exit(2);
} catch (CapSkipError | RuntimeException $e) {
    if (!headers_sent()) {
        http_response_code(502);
    }
    echo get_class($e), ': ', $e->getMessage(), "\n";
    exit(1);
}
# From the same PowerShell prompt, in the folder that holds the file
php hcaptcha_form.php

mock के सामने फ़ाइल ने ऐसा व्यवहार किया। पहली पाँच पंक्तियाँ Guzzle 8 के साथ PHP 8.0.30, 8.4.15 और 8.5.0 पर चलीं, और web server वाली पंक्तियाँ Guzzle 7 के साथ 8.4.15 पर भी। बाकी सभी छह वर्ज़न पर दोनों Guzzle वर्ज़न के साथ चलीं।

mock सेटिंगscript ने क्या किया
हल में 12 सेकंड लगते हैं, command linepolls 0, 0.3, 0.8, 1.8, 3.8, 7.8 और 12.8 सेकंड पर, फिर फ़ॉर्म करीब 13 सेकंड बाद status 200 के साथ स्वीकार हुआ
हल में 38 सेकंड लगते हैं, built-in web server, 30 सेकंड की सीमाकरीब 43 सेकंड बाद status 200, आख़िरी poll 42.9 पर
वही, set_time_limit call हटाकरकरीब 33 सेकंड बाद PHP का fatal error। पेज की body PHP का error text थी, और आख़िरी poll करीब 28 सेकंड पर जा चुका था
दूसरी पंक्ति जैसा ही, call हटाकर और BUDGET 25 रखकरStatus 504 और text out of time: timeout 24 exceeded, करीब 28 सेकंड बाद
ऐसा टास्क जो कभी पूरा नहीं होता, BUDGET 25, command lineTimeoutException, exit code 2 और संदेश timeout 24 exceeded करीब 28 सेकंड बाद, आख़िरी poll 22.9 पर
पहले दो हल ठुकराए गएerror_log में दो पंक्तियों के बाद तीसरा टास्क पास हुआ
हर हल ठुकराया गयातीन कोशिश की पंक्तियाँ, फिर तीन टास्क के बाद एक RuntimeException, साइट को कोई रिक्वेस्ट नहीं
पहले post का जवाब 403 आयादूसरा token माँगा गया और वह post स्वीकार हुआ
खाली sitekey, या ऐसा पेज पता जो absolute नहीं हैतुरंत एक ValidationException। mock को कोई टास्क नहीं दिखा, और साइट से कभी संपर्क नहीं हुआ
poll पर ERROR_PROXY_CONNECT_REFUSEDscript अपने पहले टास्क के बाद रुक गई और कुछ भी retry नहीं किया
CapSkip के port पर कुछ सुन नहीं रहाकरीब 2 सेकंड बाद एक NetworkException

PHP में hCaptcha हल करते समय आम errors

400 और 403 के फ़ैसले मेरी mock के नियम हैं। account errors CapSkip app के source को पढ़ने से आते हैं, और मैंने उन्हें चलाया नहीं।

आप जो देखते हैंकारणफिक्स
Fatal error: Maximum execution time of 30 seconds exceededPHP की सीमा SDK के इंतज़ार के भीतर खत्म हो गई। set_time_limit call गायब है, या host ने वह function बंद कर रखी हैcall को sign_up में रहने दें। अगर host ने उसे बंद कर रखा है, तो BUDGET को सीमा से कम से कम 10 सेकंड कम रखें
out of time: timeout 89 exceeded (HTTP 504, exit code 2)एक TimeoutException: timeout के भीतर कोई token नहीं आया। CapSkip पूरा नहीं कर पाया था, या टास्क अब भी खाली thread का इंतज़ार कर रहा थाCapSkip Monitor में टास्क देखें। BUDGET तभी बढ़ाएँ जब PHP के आगे लगा हर timeout इसकी इजाज़त दे
ValidationExceptionSDK ने PHP से कोई भी रिक्वेस्ट निकलने से पहले call रोक दी: खाली sitekey, relative या non-http पेज पता, 0, 1, true और false के बाहर का invisible मान, या domain जैसा अनजाना option। संदेश बताता है कि कौन-सावह argument ठीक करें जिसका संदेश नाम लेता है
ApiException जिसके संदेश में ERROR_CAPTCHA_UNSOLVABLE हैwidget पास नहीं हुआनया टास्क सबमिट करें, जो sign_up तीन बार तक करता है
ERROR_RECAPTCHA_INVALID_SITEKEY वाला ApiExceptionदस्तावेज़ों के अनुसार, hCaptcha ने उस पेज के लिए वह sitekey स्वीकार नहीं कियाdata-sitekey फिर से कॉपी करें और पक्का करें कि PAGE_URL वही पेज है जिस पर widget दिखता है
ApiException, ERROR_PROXY_CONNECT_REFUSED के साथCapSkip proxy option में बताए proxy से कनेक्ट नहीं कर पा रहाproxy का पता और type जाँचें, या proxy option हटा दें
ERROR_WRONG_USER_KEY या ERROR_KEY_DOES_NOT_EXIST वाला ApiExceptionCapSkip keys जाँच रहा है, और "apiKey" key गायब या गलत हैवह key दें जो CapSkip को चाहिए, constructor array की "apiKey" key के रूप में
ERROR_NO_SLOT_AVAILABLE, ERROR_ZERO_BALANCE या ERROR_IP_NOT_ALLOWED वाला ApiExceptionCapSkip में key जाँच से आने वाले account errors: key अपनी रिक्वेस्ट rate limit से ऊपर है, इस method के लिए उसके credits खत्म हैं, या वह किसी दूसरे IP पते वाले device से बँधी हैCapSkip में key की सेटिंग्स जाँचें। rate limit के लिए कुछ सेकंड रुकें और script फिर चलाएँ
NetworkException: Failed to connect to 127.0.0.1 port 8080constructor array के host और port पर कोई सर्वर जवाब नहीं देताCapSkip शुरू करें, फिर उसकी कनेक्शन सेटिंग्स को array से मिलाएँ। दूसरी मशीन की script को Server mode चाहिए
Deprecated: Function curl_close() is deprecatedPHP 8.5 curl_close को deprecate करता है, और SDK की Http.php CapSkip को हर रिक्वेस्ट के बाद अब भी उसे call करती है। हल काम करता है, पर display_errors चालू होने पर notice आउटपुट की शुरुआत में आ जाता है, इसलिए वेब पेज अपना 504 या 502 status नहीं पा सकताजब तक SDK curl_close हटाता नहीं, error_reporting में E_DEPRECATED बंद करें, या display_errors बंद करें
cURL error 60: SSL certificate problemWindows के लिए PHP curl.cainfo बिना सेट किए आता है (यहाँ छहों builds पर वह खाली था), इसलिए Guzzle https साइट पर फेल होता है। SDK की अपनी रिक्वेस्ट http पर CapSkip तक जाती हैं और प्रभावित नहीं होतींcacert.pem फ़ाइल डाउनलोड करें, जैसे curl.se से, और php.ini में curl.cainfo को उसके path पर सेट करें
साइट से 400, कोई session cookie नहींpost उस cookie के बिना गई जो पेज ने सेट की थीपेज लोड करें और post एक ही client और एक ही CookieJar से करें
नए token के साथ भी साइट से 403post में Guzzle का अपना User-Agent था, या token पहले इस्तेमाल हो चुका था या करीब दो मिनट पुराना थाउसी नतीजे की "userAgent" entry भेजें, हर token के लिए एक बार, हल के तुरंत बाद
ऐसी साइट से 403 जिसे Referer चाहिएGuzzle कोई नहीं भेजताpost_form में Referer पंक्ति रहने दें

अपनी PHP script से CapSkip सर्वर तक पहुँचना

CapSkip को उस PC से हटाने का मतलब, जिस पर PHP चलता है, constructor array में host और port बदलना है। Server mode दूसरे devices को आपके नेटवर्क या पब्लिक IP पर CapSkip तक पहुँचने देता है, और सेटअप गाइड स्थिर IP की सलाह देता है। Server mode port को हर पते के लिए खुला रखकर शुरू होता है। उसे अपेक्षित मशीनों तक सीमित रखने के लिए बाकी के लिए Windows Firewall block rule जोड़ें। solver आपके हार्डवेयर पर रहता है और कुछ भी मीटर नहीं होता।

FAQ

क्या वही hcaptcha() call invisible और Enterprise widgets को संभालती है?

हाँ। SDK और API दस्तावेज़ दोनों को एक ही method मानते हैं, बस एक अतिरिक्त फ़ील्ड के साथ: invisible widget के लिए invisible को 1 पर सेट करना, और Enterprise साइट के लिए rqdata का मान data में, हर टास्क के लिए नया माँगा हुआ। दोनों में से कोई भी task_options में रखें। mock के सामने दोनों in.php तक पहुँचे, और एक retry ने नया data मान भेजा। मैं असली Enterprise साइट पर टेस्ट नहीं कर सका।

PHP में hCaptcha को वेब रिक्वेस्ट में चलाना चाहिए या command line पर?

command line आसान है। वहाँ PHP की कोई सीमा नहीं होती, इसलिए BUDGET ही अकेली घड़ी है, और Windows Task Scheduler फ़ाइल को टाइमर पर शुरू कर सकता है। जब कोई विज़िटर इंतज़ार कर रहा हो, तो पेज को job शुरू करने दें और इंतज़ार command line worker से कराएँ।

क्या PHP में hCaptcha हल करने के लिए proxy चाहिए?

टेस्ट के लिए नहीं। दस्तावेज़ कहते हैं कि CapSkip hCaptcha के लिए proxy को ज़बरदस्ती नहीं लगाता, पर एक ही IP से हलों की लगातार धारा वही है जिसे पकड़ने के लिए उसकी rate limits बनी हैं। ज़्यादा मात्रा के लिए CapSkip को उसकी सेटिंग्स में proxy list दें या proxy option दें, login:password@IP:PORT जैसी string। वह mock तक proxy और proxytype के रूप में पहुँचा। फ़ॉर्म उसी पते से Guzzle के proxy option से सबमिट करें। मैंने कोई असली proxy टेस्ट नहीं किया।

PHP में hCaptcha हल करना तीन चीज़ों पर टिका है: आपके तय किए timeout के साथ एक hcaptcha() call, job की शुरुआत में एक set_time_limit call, और हर दूसरे timeout के नीचे एक BUDGET। retry सिर्फ़ उसी पर करें जिसे CapSkip हल नहीं कर पाया, और token के साथ आए User-Agent के तहत post करें। क्योंकि CapSkip एक असीमित कैप्चा सॉल्वर है, जो फिक्स्ड कीमत वाले लाइसेंस पर चलता है, इसलिए ठुकराए गए token की क़ीमत बस loop से एक और बार गुज़रना है। बाकी CAPTCHA प्रकारों के SDK calls के लिए PHP कैप्चा सॉल्वर पेज देखें। widget कैसे पास होता है, यह hCaptcha डेमो में दिखाया गया है।