hCaptcha in PHP: Mit dem CapSkip-SDK und Guzzle lösen

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

Um hCaptcha in PHP zu lösen, installieren Sie capskip/capskip und rufen hcaptcha() mit dem sitekey und der Seitenadresse auf. Der CapSkip-hCaptcha-Löser liefert einen Token plus den User-Agent, mit dem er ausgestellt wurde. Der PHP-Teil ist die Uhr: Eine Lösung dauert laut CapSkip-Dokumentation 10 bis 30 Sekunden, das SDK wartet bis zu 300, wenn Sie kein Timeout übergeben, und PHP beendet eine Webanfrage nach 30. Dieser Leitfaden bringt das Timeout in dieses Limit und sendet das Formular dann mit Guzzle.

Was Sie brauchen

  • Ein Windows-Rechner mit CapSkip 4.0.0 oder neuer, der ersten Version, die hCaptcha beherrscht.
  • Composer und PHP 8.0.2 oder neuer, mit aktivierten Erweiterungen curl und json. Das SDK verlangt 8.0, und unter 8.0.30 nennt die Plattformprüfung von Composer für das SDK plus Guzzle 8.0.2. Die Methode hcaptcha kam mit SDK-Version 1.6.0. Ich habe PHP 8.0.30, 8.1.33, 8.2.29, 8.3.28, 8.4.15 und 8.5.0 für Windows ausgeführt, jeweils mit Guzzle 7.16.1 und mit Guzzle 8.3.0.
  • Ein Formular, das ein hCaptcha-Widget schützt und das Sie automatisieren dürfen, und der sitekey des Widgets.
  • Ein Weg zu CapSkip. Der Local-Modus antwortet nur auf dem PC, auf dem er läuft (127.0.0.1). Der Server-Modus antwortet zusätzlich auf Ihrer Netzwerkadresse oder öffentlichen IP. Die Verbindungseinstellungen sind der Ort, an dem Sie den Modus wählen.
# In a PowerShell prompt, in the folder that will hold hcaptcha_form.php
composer require capskip/capskip guzzlehttp/guzzle

So wurde getestet: gegen einen selbst geschriebenen Mock von in.php und res.php nach dem hCaptcha-Abschnitt der API-Dokumentation, mit einer falschen Anmeldeseite daneben. An eine echte CapSkip-App oder hCaptcha-Website ging keine Anfrage, daher ist jede Lösezeit unten eine Einstellung des Mocks, und die Prüfungen der Seite (eine Verwendung pro Token, ein passender User-Agent, zwei Minuten Lebensdauer) sind die Regeln der Dokumentation, wie ich sie programmiert habe. Die PHP-Seite ist echt: das SDK, Guzzle und PHP unter Windows, auf der Kommandozeile und unter dem eingebauten Webserver, nicht unter Apache oder IIS. Die Entwicklerdokumente von hCaptcha behandeln die echte Verifizierung.

Schritt 1: hcaptcha() mit einem eigenen Timeout aufrufen

Legen Sie die vier PHP-Blöcke in der gezeigten Reihenfolge in eine Datei namens hcaptcha_form.php. Der sitekey ist ein Attribut data-sitekey am h-captcha-Container, die Option sitekey von hcaptcha.render() oder der Parameter sitekey= in der iframe-Adresse des Widgets. Fügen Sie ihn in SITEKEY ein und setzen Sie PAGE_URL.

Die Methode ist hcaptcha(string $sitekey, string $url, array $options = []). Das Options-Array nimmt die Schlüssel "timeout", "invisible" (1 oder true), "data" (der rqdata-Wert einer Enterprise-Website), "userAgent" und "proxy". Bevor es etwas sendet, lehnt das SDK einen leeren sitekey, eine Seitenadresse, die kein absolutes http oder https ist, einen invisible-Wert außer 0, 1, true oder false und jede Option ab, die CapSkip nicht annimmt, darunter die Option domain von 2Captcha. Jede Ablehnung ist eine ValidationException.

Das zurückgegebene Array hat einen Eintrag "token" für h-captcha-response und g-recaptcha-response, einen Eintrag "code" mit demselben String, einen Eintrag "userAgent" und einen Eintrag "captchaId". Sein Eintrag "respKey" ist der zweite Wert von hCaptcha, leer, wenn es keinen gibt, und die meisten Websites lesen ihn nie. In der Funktion task_options stehen die Schlüssel invisible oder data, und sie läuft für jede Aufgabe, weil ein rqdata-Wert nur einmal gilt. Ist API Key Validation eingeschaltet, fügen Sie dem Konstruktor-Array einen Schlüssel "apiKey" hinzu.

<?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());
}

Schritt 2: das Warten innerhalb des Zeitlimits von PHP halten

Der Aufruf hcaptcha() blockiert. Er sendet die Aufgabe und fragt dann ab, bis der Token bereit ist oder das Timeout endet. Eine Webanfrage bekommt 30 Sekunden max_execution_time, die Kommandozeile aber keine: Ihr Limit las hier 0, auch mit 30 in php.ini, während der eingebaute Webserver von PHP 30 las. Ich nutzte unter Windows ein Limit von 5 Sekunden, und PHP 8.0.30, 8.4.15 und 8.5.0 verhielten sich gleich.

Was ich mit einem Limit von 5 Sekunden ausgeführt habeWas passiert ist
Ein einzelner Sleep von 10 SekundenDer Fatal Error kam nach 10,0 Sekunden, als der Sleep zurückkehrte
Sleep in Schritten von 0,25 SekundenDer Fatal Error kam nach 5,2 Sekunden
Der Aufruf hcaptcha() bei einer Aufgabe, die nie fertig wurdeDer Fatal Error kam nach 7,8 Sekunden, als der Sleep des SDK von 3,8 bis 7,8 Sekunden zurückkehrte
Ein try-Block mit catch und finally um den SleepKeines von beiden lief. Eine Funktion aus register_shutdown_function lief, und error_get_last enthielt die Meldung
set_time_limit(5) nach 3 Sekunden, dann ein Sleep von 4 SekundenKein Fehler. Das Skript lief insgesamt 7,0 Sekunden
set_time_limit(0) nach 2 Sekunden, mit einem Limit von 3 Sekunden, dann ein Sleep von 5 SekundenKein Fehler. Das Skript lief insgesamt 7,0 Sekunden

Drei Regeln folgen daraus. PHP unterbricht nie einen Sleep oder einen cURL-Aufruf, und mehr tut das SDK beim Warten nicht. Es prüft das Limit erst, wenn die Kontrolle zurückkehrt, daher kann ein Warten um seine volle Länge überziehen. Ein Fatal Error überspringt catch und finally, daher kann Ihr Handler den Job nicht retten. Und set_time_limit startet den Zähler neu, statt zu addieren. Ich habe nur Windows ausgeführt, und das PHP-Handbuch zu set_time_limit sagt, dass andere Systeme Schlafen oder das Warten auf einen Socket nicht mitzählen.

Das Polling des SDK entscheidet den Rest, wie im Quelltext gelesen und gegen den Mock geprüft. Die erste Abfrage geht sofort hinaus, dann schläft es 0,25; 0,5; 1; 2 und 4 Sekunden und danach 5 Sekunden zwischen den Abfragen. Das Timeout ist eine Frist für den Start einer Abfrage, nicht für die Antwort. Bei einem Timeout von 20 ging die letzte Abfrage bei 17,8 Sekunden hinaus und die TimeoutException kam bei 22,9, ein Token, der bei 19 Sekunden bereit wurde, wurde also nie gelesen. Ein Timeout von 0 fällt auf den defaultTimeout des SDK von 120 Sekunden zurück, den die Funktion solve vermeidet.

BUDGET ist daher die eine Zahl, die Ihnen gehört: wie lange eine Registrierung auf Tokens warten darf, geteilt von allen Versuchen. Schritt 4 gibt PHP BUDGET plus 30 Sekunden, damit Ihre Frist zuerst auslöst, als TimeoutException, die Sie abfangen können, nie als Fatal Error, den Sie nicht abfangen können. Halten Sie BUDGET unter jedem Timeout eines Webservers vor PHP, das set_time_limit nicht berührt. CapSkip kann eine Aufgabe außerdem für einen freien hCaptcha-Thread zurückhalten, im gelesenen App-Quelltext bis zu 250 Sekunden, erhöhen Sie BUDGET daher zusammen mit dem Limit von PHP, wenn Sie viele Lösungen einreihen.

Schritt 3: das Formular mit dem Cookie-Jar und dem richtigen User-Agent senden

Das Laden der Seite und der Post müssen wie ein einziger Besucher aussehen. Ein Guzzle-Client behält keine Cookies, solange Sie ihm kein Jar geben, daher baut post_form einen Client mit einem neuen CookieJar, lädt die Seite und sendet mit den Cookies, die die Seite gesetzt hat.

Der Token gehört auch zu einer Browser-Identität. Laut Dokumentation nennt die Antwort den User-Agent, mit dem CapSkip gelöst hat, und das Formular muss unter ihm gesendet werden. Guzzle würde sich stattdessen selbst ankündigen: Der Mock sah GuzzleHttp/8 (GuzzleHttp/7 unter Guzzle 7) beim Laden der Seite, als der Header fehlte, und lehnte den Post ab. Ein Standard-User-Agent am Website-Client deckt beide Anfragen ab, daher wird dieser Client nach der Lösung erstellt. Der Schlüssel "userAgent" ändert daran nichts, weil CapSkip ihn laut Dokumentation nur nutzt, wenn er zu seinem eigenen Browser passt.

Der Post sendet die Seitenadresse als Referer. Guzzle fügt keinen hinzu, und manche Frameworks, darunter Django, lehnen einen HTTPS-Formular-POST ohne Referer und ohne Origin ab. Eine Mock-Website mit dieser Regel antwortete 403, bis der Header da war. Die Funktion hidden_fields kopiert die versteckten Eingaben des Formulars, zum Beispiel einen CSRF-Token. Ihr Präfix loadHTML lässt libxml UTF-8 lesen: Ohne es kam bei einer Seite ohne Meta-Tag charset ein Buchstabe mit Akzent in einem versteckten Wert verstümmelt an, und der Mock lehnte den Post ab. Das Widget füllt h-captcha-response und g-recaptcha-response, daher sendet der Code beide.

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();
}

Schritt 4: mit Wiederholungen registrieren, dann ausführen

Die Funktion sign_up nimmt zuerst die Zeit. Hat PHP ein Limit und gibt es set_time_limit, startet sie die Uhr mit BUDGET plus 30 Sekunden neu, Platz für das letzte Schlafen des SDK und den Formular-POST. Auf der Kommandozeile, wo das Limit 0 ist, ändert sie nichts. Ein späterer Versuch beginnt nur, wenn noch 10 Sekunden des Budgets übrig sind. Der letzte Block wählt den Exit: 2 für Zeit abgelaufen, 1 für jeden anderen Fehler, dazu ein Status 504 oder 502 für eine Webseite. Er fängt CapSkipError und RuntimeException nebeneinander ab, weil alle Exceptions des SDK CapSkipError erweitern, das keine RuntimeException ist.

Manche Hosts deaktivieren set_time_limit, und dann ist der Fatal Error zurück. Bei einem Limit von 30 Sekunden und BUDGET bei 90 kam er nach etwa 33 Sekunden, im Sleep des SDK nach seiner Abfrage bei etwa 28 Sekunden. Ein BUDGET von 29 scheiterte genauso, während 25 mit der TimeoutException nach etwa 28 Sekunden endete. Ohne den Aufruf halten Sie BUDGET mindestens 10 Sekunden unter dem Limit.

Nur ERROR_CAPTCHA_UNSOLVABLE verdient eine neue Aufgabe. Die Dokumentation nennt ERROR_RECAPTCHA_INVALID_SITEKEY und ERROR_PROXY_CONNECT_REFUSED gesondert, weil eine erneut gesendete Aufgabe genauso scheitern würde, daher beenden sie das Skript. Das SDK legt den Antworttext von CapSkip in die Meldung der ApiException, und der App-Quelltext baut einen JSON-Fehler als Objekt mit status 0 und dem Code in request, daher durchsucht der Code die Meldung mit str_contains. Lehnt die Website einen Post ab, fragt die Schleife einen frischen Token an, da ein Token nur einmal funktioniert. Ein Status unter 400 heißt nur, dass die Website die Anfrage nicht abgelehnt hat, prüfen Sie daher auch auf Text, den nur ein Erfolg zeigt.

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

So verhielt sich die Datei gegen den Mock. Die ersten fünf Zeilen liefen auf PHP 8.0.30, 8.4.15 und 8.5.0 mit Guzzle 8, und die Zeilen zum Webserver auch auf 8.4.15 mit Guzzle 7. Der Rest lief auf allen sechs Versionen mit beiden Guzzle-Versionen.

Mock-EinstellungWas das Skript tat
Lösung dauert 12 Sekunden, KommandozeileAbfragen bei 0; 0,3; 0,8; 1,8; 3,8; 7,8 und 12,8 Sekunden, dann wurde das Formular nach etwa 13 Sekunden mit Status 200 akzeptiert
Lösung dauert 38 Sekunden, eingebauter Webserver, Limit von 30 SekundenStatus 200 nach etwa 43 Sekunden, die letzte Abfrage bei 42,9
Dasselbe, mit gelöschtem Aufruf set_time_limitFatal Error von PHP nach etwa 33 Sekunden. Der Body der Seite war der Fehlertext von PHP, und die letzte Abfrage war bei etwa 28 Sekunden hinausgegangen
Dasselbe wie die zweite Zeile, mit gelöschtem Aufruf und BUDGET auf 25Status 504 und der Text out of time: timeout 24 exceeded, nach etwa 28 Sekunden
Eine Aufgabe, die nie fertig wird, BUDGET 25, KommandozeileTimeoutException, Exit-Code 2 und die Meldung timeout 24 exceeded nach etwa 28 Sekunden, mit der letzten Abfrage bei 22,9
Die ersten zwei Lösungen abgelehntDie dritte Aufgabe bestand, nach zwei Zeilen in error_log
Jede Lösung abgelehntDrei Versuchszeilen, dann eine RuntimeException nach drei Aufgaben, ohne Anfrage an die Website
Der erste Post wurde mit 403 beantwortetEin zweiter Token wurde angefordert, und dieser Post wurde akzeptiert
Leerer sitekey oder eine Seitenadresse, die nicht absolut istSofort eine ValidationException. Der Mock sah keine Aufgabe, und die Website wurde nie kontaktiert
ERROR_PROXY_CONNECT_REFUSED bei der AbfrageDas Skript stoppte nach seiner ersten Aufgabe und wiederholte nichts
Nichts lauscht am CapSkip-PortEine NetworkException nach etwa 2 Sekunden

Häufige Fehler beim Lösen von hCaptcha in PHP

Die Urteile 400 und 403 sind die Regeln meines Mocks. Die Kontofehler stammen aus dem Lesen des App-Quelltexts von CapSkip, und ich habe sie nicht ausgeführt.

Was Sie sehenUrsacheBeheben
Fatal error: Maximum execution time of 30 seconds exceededDas Limit von PHP lief im Warten des SDK ab. Der Aufruf set_time_limit fehlt, oder der Host hat diese Funktion deaktiviertBehalten Sie den Aufruf in sign_up. Hat der Host ihn deaktiviert, setzen Sie BUDGET mindestens 10 Sekunden unter das Limit
out of time: timeout 89 exceeded (HTTP 504, Exit-Code 2)Eine TimeoutException: Innerhalb des Timeouts kam kein Token an. CapSkip war nicht fertig, oder die Aufgabe wartete noch auf einen freien ThreadSehen Sie sich die Aufgabe im CapSkip Monitor an. Erhöhen Sie BUDGET nur, wenn jedes Timeout vor PHP es zulässt
ValidationExceptionDas SDK stoppte den Aufruf, bevor eine Anfrage PHP verließ: ein leerer sitekey, eine relative Seitenadresse oder eine, die nicht http ist, ein invisible-Wert außer 0, 1, true und false oder eine unbekannte Option wie domain. Die Meldung sagt, welcheKorrigieren Sie das Argument, das die Meldung nennt
ApiException, deren Meldung ERROR_CAPTCHA_UNSOLVABLE enthältDas Widget wurde nicht bestandenSenden Sie eine neue Aufgabe, was sign_up bis zu dreimal tut
ApiException mit ERROR_RECAPTCHA_INVALID_SITEKEYhCaptcha hat diesen sitekey für diese Seite laut Dokumentation nicht akzeptiertKopieren Sie data-sitekey neu und bestätigen Sie, dass PAGE_URL die Seite ist, die das Widget zeigt
ApiException mit ERROR_PROXY_CONNECT_REFUSEDCapSkip kann sich nicht mit dem Proxy verbinden, der in der Option proxy stehtPrüfen Sie Adresse und Typ des Proxys, oder lassen Sie die Option proxy weg
ApiException mit ERROR_WRONG_USER_KEY oder ERROR_KEY_DOES_NOT_EXISTCapSkip prüft Schlüssel, und der Schlüssel "apiKey" fehlt oder ist falschÜbergeben Sie den Schlüssel, den CapSkip erwartet, als Schlüssel "apiKey" des Konstruktor-Arrays
ApiException mit ERROR_NO_SLOT_AVAILABLE, ERROR_ZERO_BALANCE oder ERROR_IP_NOT_ALLOWEDKontofehler aus den Schlüsselprüfungen in CapSkip: Der Schlüssel hat sein Ratenlimit für Anfragen überschritten, hat keine Credits mehr für diese Methode oder ist an ein Gerät mit einer anderen IP-Adresse gebundenPrüfen Sie die Einstellungen des Schlüssels in CapSkip. Warten Sie beim Ratenlimit einige Sekunden und führen Sie das Skript erneut aus
NetworkException: Failed to connect to 127.0.0.1 port 8080Unter dem Host und Port im Konstruktor-Array antwortet kein ServerStarten Sie CapSkip und vergleichen Sie dann seine Verbindungseinstellungen mit dem Array. Ein Skript auf einem anderen Rechner braucht den Server-Modus
Deprecated: Function curl_close() is deprecatedPHP 8.5 markiert curl_close als veraltet, und die Datei Http.php des SDK ruft es nach jeder Anfrage an CapSkip weiterhin auf. Die Lösung funktioniert, aber bei eingeschaltetem display_errors beginnt der Hinweis die Ausgabe, sodass eine Webseite ihren Status 504 oder 502 nicht mehr bekommen kannSchalten Sie E_DEPRECATED in error_reporting aus oder display_errors aus, bis das SDK curl_close aufgibt
cURL error 60: SSL certificate problemPHP für Windows wird mit nicht gesetztem curl.cainfo ausgeliefert (bei allen sechs Builds hier war es leer), daher scheitert Guzzle bei einer https-Website. Die eigenen Anfragen des SDK gehen per http an CapSkip und sind nicht betroffenLaden Sie eine Datei cacert.pem herunter, zum Beispiel von curl.se, und setzen Sie curl.cainfo in php.ini auf ihren Pfad
400 von der Website, kein Sitzungs-CookieDer Post ging ohne das Cookie hinaus, das die Seite gesetzt hatLaden Sie die Seite und senden Sie über einen Client mit einem CookieJar
403 von der Website bei einem frischen TokenDer Post trug den eigenen User-Agent von Guzzle, oder der Token war schon benutzt worden oder etwa zwei Minuten altSenden Sie den Eintrag "userAgent" aus demselben Ergebnis, einmal pro Token, direkt nach der Lösung
403 von einer Website, die einen Referer willGuzzle sendet keinenBehalten Sie die Zeile Referer in post_form

Einen CapSkip-Server von Ihrem PHP-Skript aus erreichen

Wenn Sie CapSkip von dem PC wegbewegen, auf dem PHP läuft, ändern Sie Host und Port im Konstruktor-Array. Der Server-Modus lässt andere Geräte CapSkip in Ihrem Netzwerk oder über die öffentliche IP erreichen, und die Einrichtungsanleitung empfiehlt eine statische. Der Server-Modus startet mit dem Port offen für jede Adresse. Damit er nur den erwarteten Rechnern offensteht, fügen Sie eine Blockierregel der Windows Firewall für die anderen hinzu. Der Solver bleibt auf Ihrer Hardware, und es wird nichts nach Verbrauch abgerechnet.

FAQ

Deckt derselbe Aufruf hcaptcha() unsichtbare und Enterprise-Widgets ab?

Ja. Das SDK und die API-Dokumentation behandeln beide als dieselbe Methode mit einem zusätzlichen Feld: invisible auf 1 für ein unsichtbares Widget und den rqdata-Wert in data für eine Enterprise-Website, für jede Aufgabe neu angefordert. Legen Sie beides in task_options. Gegen den Mock kamen beide bei in.php an, und eine Wiederholung sendete einen neuen Wert data. Eine echte Enterprise-Website konnte ich nicht testen.

Sollte hCaptcha in PHP in einer Webanfrage oder auf der Kommandozeile laufen?

Die Kommandozeile ist einfacher. PHP hat dort kein Limit, daher ist BUDGET die einzige Uhr, und der Windows-Aufgabenplaner kann die Datei zeitgesteuert starten. Wartet ein Besucher, lassen Sie die Seite den Job starten und einen Worker auf der Kommandozeile das Warten übernehmen.

Braucht das Lösen von hCaptcha in PHP einen Proxy?

Nicht für einen Test. Laut Dokumentation erzwingt CapSkip für hCaptcha keinen Proxy, aber ein stetiger Strom von Lösungen von einer IP ist genau das, was seine Ratenbegrenzungen erkennen sollen. Geben Sie CapSkip bei größeren Mengen eine Proxy-Liste in seinen Einstellungen oder übergeben Sie die Option proxy, einen String wie login:password@IP:PORT. Er kam beim Mock als proxy und proxytype an. Senden Sie das Formular mit der Option proxy von Guzzle von derselben Adresse. Einen echten Proxy habe ich nicht getestet.

hCaptcha in PHP zu lösen heißt: ein Aufruf hcaptcha() mit einem von Ihnen gesetzten Timeout, ein Aufruf set_time_limit am Anfang des Jobs und ein BUDGET unter jedem anderen Timeout. Wiederholen Sie nur, was CapSkip nicht lösen konnte, und senden Sie mit dem User-Agent, der zum Token gehörte. Da CapSkip ein unbegrenzter Captcha-Löser mit Pauschallizenz ist, kostet ein abgelehnter Token nur einen weiteren Durchlauf der Schleife. Die PHP-Captcha-Solver-Seite führt die SDK-Aufrufe für die anderen Captcha-Typen auf. Die hCaptcha-Demo zeigt, wie ein Widget bestanden wird.