Captcha umgehen mit PHP

Integrieren Sie das PHP-Paket zur Umgehung der Captcha-Automatisierungslösung. Beste erfolgreiche Captcha-Erkennungsrate.

PHP-Paket zur einfachen Integration mit der API von 2Captcha Captcha-Lösungsdienst, um reCAPTCHA zu umgehen, hCaptcha, Arkose captcha, Geetest und beliebige andere Captchas zu lösen

Schnellstart

Installation

Das Skriptpaket kann mit dem Paketinstallationsprogramm oder manuell installiert werden

Ersteller

Zur automatischen Installation eines Bibliothekspakets müssen Sie die Standardlösung für Python-Pakete verwenden - Pip. Laden Sie es von dem Link herunter und installieren Sie es gemäß den Anweisungen. Nach der Installation der Anwendung, verwenden Sie den Befehl:

composer require 2captcha/2captcha

Manual

Laden Sie den Inhalt des Ordners src in Ihr Projekt und aktivieren Sie den Autoloader src/autoloader.php mit dem Befehl:

require 'path/to/autoloader.php';

Wir laden Sie ein, unser Repositorium GitHub zu erkunden, in dem Sie Bibliotheken und Module für die einfache Integration mit unserer API finden können.

Konfiguration

Beschreibung aller notwendigen Parameter zur Konfiguration des installierten Pakets

Eine Instanz der Klasse TwoCaptcha kann wie folgt erstellt werden:

$solver = new \TwoCaptcha\TwoCaptcha('YOUR_API_KEY');

Sie haben auch die Möglichkeit, einige der Optionen für die erstellte Instanz anzupassen:

$solver = new \TwoCaptcha\TwoCaptcha([
    'apiKey'           => 'YOUR_API_KEY',
    'softId'           => 123,
    'callback'         => 'https://your.site/result-receiver',
    'defaultTimeout'   => 120,
    'recaptchaTimeout' => 600,
    'pollingInterval'  => 10,
]);
Optionen für die TwoCaptcha-Instanz
OptionStandardwertBeschreibung
softId-Ihre Software-ID, die Sie nach der Veröffentlichung im 2Captcha Softwarekatalog erhalten
callback-Die URL Ihres Web-Servers, der das Captcha-Erkennungsergebnis empfängt. Die URL sollte zuerst in den Pingback-Einstellungen Ihres Kontos registriert werden.
defaultTimeout120Abfragezeitlimit in Sekunden für alle Captcha-Typen außer reCAPTCHA. Definiert, wie lange das Modul versucht, die Antwort vom res.php API-Endpunkt zu erhalten.
recaptchaTimeout600Abfragezeitlimit in Sekunden für alle Captcha-Typen. Definiert, wie lange das Modul versucht, die Antwort vom res.php API-Endpunkt zu erhalten.
pollingInterval10Intervall in Sekunden zwischen Anfragen an den res.php API-Endpunkt, Werte unter 5 Sekunden werden nicht empfohlen
WICHTIG: Sobald Callback für die Instanz TwoCaptcha definiert ist, geben alle Methoden nur die Captcha-ID zurück und fragen NICHT die API ab, um das Ergebnis zu erhalten. Das Ergebnis wird an die Callback-URL gesendet. Um die Antwort manuell zu erhalten, verwenden Sie die getResult-Methode

Captcha lösen

Wenn Sie ein bildbasiertes Captcha einreichen, können Sie zusätzliche Optionen angeben, um 2Captcha Mitarbeitern zu helfen, es richtig zu lösen

Captcha-Optionen
OptionStandardwertBeschreibung
numeric0Legt fest, ob Captcha numerische oder andere Symbole enthält Weitere Informationen in den API-Dokumenten
minLength0Minimale Länge der Antwort
maxLength0maximale Länge der Antwort
phrase0definiert, ob die Antwort mehrere Wörter enthält oder nicht
caseSensitive0definiert, ob bei der Antwort Groß- und Kleinschreibung zu beachten ist
calc0definiert die Berechnung von Captcha
lang-definiert die Captcha-Sprache, siehe die Liste der unterstützten Sprachen
hintImg-ein Bild mit Hinweis, das den Mitarbeitern mit dem Captcha angezeigt wird
hintText-Hinweis oder Aufgabentext, der den Mitarbeitern mit dem Captcha angezeigt wird

Um ein normales Captcha (verzerrter Text auf dem Bild) zu umgehen, verwenden Sie die folgende Methode. Diese Methode kann auch verwendet werden, um einen beliebigen Text auf dem Bild zu erkennen.

$result = $solver->normal('path/to/captcha.jpg');

Diese Methode kann verwendet werden, um ein Captcha zu umgehen, das die Beantwortung einer Frage im Klartext verlangt.

$result = $solver->text('If tomorrow is Saturday, what day is today?');

Verwenden Sie diese Methode, um reCAPTCHA V2 zu lösen und ein Token zur Umgehung des Schutzes zu erhalten.

$result = $solver->recaptcha([
    'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
    'url'     => 'https://mysite.com/page/with/recaptcha',
]);

Diese Methode stellt den reCAPTCHA V3-Löser bereit und gibt ein Token zurück.

$result = $solver->recaptcha([
    'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
    'url'     => 'https://mysite.com/page/with/recaptcha',
    'version' => 'v3',
]);

FunCaptcha (Arkoselabs) Lösungsmethode. Gibt ein Token zurück.

Methode zum Lösen des GeeTest-Puzzle-Captcha. Gibt eine Reihe von Token als JSON zurück.

Verwenden Sie diese Methode, um die hCaptcha-Herausforderung zu lösen. Gibt ein Token zur Umgehung von Captcha zurück.

$result = $solver->hcaptcha([
    'sitekey'   => '10000000-ffff-ffff-ffff-000000000001',
    'url'       => 'https://www.site.com/page/',
]);

Token-basierte Methode zur Lösung von KeyCaptcha.

Token-basierte Methode zur Umgehung des Capy Puzzle-Captcha.

Die Grid-Methode wird ursprünglich als Old reCAPTCHA V2 Methode bezeichnet. Die Methode kann verwendet werden, um jede Art von Captcha zu umgehen, bei der Sie ein Gitter auf ein Bild anwenden können und bestimmte Gitterfelder anklicken müssen. Gibt die Anzahl der Felder zurück.

$result = $solver->grid('path/to/captcha.jpg');

Die Methode Canvas kann verwendet werden, wenn Sie eine Linie um ein Objekt auf einem Bild zeichnen müssen. Gibt einen Satz von Punktkoordinaten zurück, um ein Polygon zu zeichnen.

Die ClickCaptcha-Methode gibt die Koordinaten von Punkten auf dem Captcha-Bild zurück. Kann verwendet werden, wenn Sie auf bestimmte Punkte des Bildes klicken müssen.

Diese Methode kann verwendet werden, um ein Captcha zu lösen, bei dem ein Objekt gedreht werden muss. Meistens verwendet, um FunCaptcha zu umgehen. Gibt den Rotationswinkel zurück.

$result = $solver->rotate('path/to/captcha.jpg');

Sonstige Methoden

Zusätzliche gültige Methoden, die bei der Arbeit an den Hauptskripten verwendet werden

send / getResult

Diese Methoden können für die manuelle Captcha-Eingabe und die Abfrage von Antworten verwendet werden.

$id = $solver->send(['file' => 'path/to/captcha.jpg', ...]);

sleep(20);

$code = $solver->getResult($id);

balance

Verwenden Sie diese Methode, um das Guthaben Ihres Kontos abzurufen.

$balance = $solver->balance();

report

Verwenden Sie diese Methode, um positive oder negative Captcha-Antworten zu melden.

$solver->report($id, true); // captcha solved correctly
$solver->report($id, false); // captcha solved incorrectly

Fehlerbehandlung

Mögliche Varianten von Standardfehlern, die der Dienst bei der Bearbeitung von Anfragen zurückgibt

Im Falle eines Fehlers wirft der Captcha Solver eine Ausnahme. Es ist wichtig, diese Fälle richtig zu behandeln. Wir empfehlen, try/catch zu verwenden, um Ausnahmen zu behandeln.

try {
    $result = $solver->text('If tomorrow is Saturday, what day is today?');
} catch (\TwoCaptcha\Exception\ValidationException $e) {
    // invalid parameters passed
} catch (\TwoCaptcha\Exception\NetworkException $e) {
    // network error occurred
} catch (\TwoCaptcha\Exception\ApiException $e) {
    // api respond with error
} catch (\TwoCaptcha\Exception\TimeoutException $e) {
    // captcha is not solved so far
}

Andere Sprachen für die Integration mit der Dienst-API