Omiń captcha za pomocą PHP
Zintegruj pakiet PHP, aby obejść rozwiązanie do automatyzacji captcha. Najlepszy wskaźnik rozpoznawalności captcha.
Pakiet PHP do łatwej integracji z API usługi rozwiązywania captcha 2Captcha w celu ominięcia reCAPTCHA, funcapte_testasolve i rozwiąż inne captcha
Szybki startInstalacja
Pakiet skryptu można zainstalować za pomocą instalatora pakietu lub ręcznie
Kompozytor
Aby automatycznie zainstalować pakiet bibliotek, należy skorzystać ze standardowego rozwiązania dla pakietów PHP - Composer. Pobierz go z linku i zainstaluj zgodnie z instrukcjami. Po zainstalowaniu aplikacji użyj polecenia:
composer require 2captcha/2captcha
Manualny
Pobierz zawartość folderu src
do swojego projektu i aktywuj autoloader src/autoloader.php
za pomocą polecenia:
require 'path/to/autoloader.php';
Zapraszamy do zapoznania się z naszym repozytorium GitHub, gdzie można znaleźć biblioteki i moduły dla łatwa integracja z naszym API.
Konfiguracja
Opis wszystkich niezbędnych parametrów do konfiguracji zainstalowanego pakietu
Instancję klasy TwoCaptcha
można utworzyć w następujący sposób:
$solver = new \TwoCaptcha\TwoCaptcha('YOUR_API_KEY');
Masz również możliwość dostosowania niektórych opcji dla tworzonej instancji:
$solver = new \TwoCaptcha\TwoCaptcha([
'apiKey' => 'YOUR_API_KEY',
'softId' => 123,
'callback' => 'https://your.site/result-receiver',
'defaultTimeout' => 120,
'recaptchaTimeout' => 600,
'pollingInterval' => 10,
]);
Opcje instancji TwoCaptcha
Option | Default value | Description |
---|---|---|
softId | - | Twój identyfikator oprogramowania uzyskany po opublikowaniu w 2Captcha software catalog |
callback | - | Adres URL Twojego serwera WWW, który otrzymuje wynik rozpoznawania captcha. Adres URL należy najpierw zarejestrować w ustawieniach pingback na swoim koncie |
defaultTimeout | 120 | Limit czasu odpytywania w sekundach dla wszystkich typów captcha z wyjątkiem reCAPTCHA. Definiuje jak długo moduł próbuje uzyskać odpowiedź z punktu końcowego API res.php |
recaptchaTimeout | 600 | Limit czasu odpytywania reCAPTCHA w sekundach. Definiuje jak długo moduł próbuje uzyskać odpowiedź z punktu końcowego API res.php |
pollingInterval | 10 | Odstęp w sekundach między żądaniami do punktu końcowego API res.php , ustawianie wartości mniejszych niż 5 sekund nie jest zalecane |
WAŻNE: po zdefiniowaniucallback
dla instancjiTwoCaptcha
wszystkie metody zwracają tylko identyfikator captcha i NIE odpytuj interfejsu API, aby uzyskać wynik. Wynik zostanie wysłany na adres URL wywołania zwrotnego. Aby uzyskać odpowiedź ręcznie, użyj metody getResult
Rozwiąż test captcha
Gdy przesyłasz obraz captcha, użycie captcha może zapewnić dodatkowe opcje, które pomogą pracownikom 2Captcha w prawidłowym rozwiązaniu problemu
Opcje captcha
Opcja | Domyślna wartość | Opis |
---|---|---|
numeric | 0 | Określa, czy captcha zawiera symbole numeryczne lub inne zobacz więcej informacji w dokumentacji interfejsu API |
minLength | 0 | minimalna długość odpowiedzi |
maxLength | 0 | maksymalna długość odpowiedzi |
phrase | 0 | określa, czy odpowiedź zawiera wiele słów, czy nie |
caseSensitive | 0 | określa, czy w odpowiedzi jest rozróżniana wielkość liter |
calc | 0 | definiuje captcha wymaga obliczeń |
lang | - | definiuje język captcha, zobacz listę obsługiwanych języków |
hintImg | - | obrazek z podpowiedzią pokazywany pracownikom za pomocą captcha |
hintText | - | podpowiedź lub tekst zadania pokazywany pracownikom za pomocą captcha |
- Normal Captcha
- Text Captcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- KeyCaptcha
- Capy
- Grid
- Canvas
- ClickCaptcha
- Rotate
Aby ominąć normalne captcha (zniekształcony tekst na obrazie), użyj następującej metody. Ta metoda może być również używana do rozpoznawania dowolnego tekstu na obrazie.
$result = $solver->normal('path/to/captcha.jpg');
Ta metoda może służyć do ominięcia captcha, która wymaga odpowiedzi na pytanie podane w postaci zwykłego tekstu.
$result = $solver->text('If tomorrow is Saturday, what day is today?');
Użyj tej metody, aby rozwiązać reCAPTCHA V2 i uzyskać token, aby ominąć ochronę.
$result = $solver->recaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/recaptcha',
]);
Ta metoda zapewnia solver reCAPTCHA V3 i zwraca token.
$result = $solver->recaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/recaptcha',
'version' => 'v3',
]);
Metoda rozwiązywania FunCaptcha (Arkoselabs). Zwraca token.
$result = $solver->funcaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/funcaptcha',
]);
Metoda rozwiązywania GeeTest puzzle captcha. Zwraca zestaw tokenów w formacie JSON.
$result = $solver->geetest([
'gt' => 'f1ab2cdefa3456789012345b6c78d90e',
'challenge' => '12345678abc90123d45678ef90123a456b',
'url' => 'https://www.site.com/page/',
]);
Oparta na tokenach metoda rozwiązywania KeyCaptcha.
$result = $solver->keycaptcha([
's_s_c_user_id' => 10,
's_s_c_session_id' => '493e52c37c10c2bcdf4a00cbc9ccd1e8',
's_s_c_web_server_sign' => '9006dc725760858e4c0715b835472f22-pz-',
's_s_c_web_server_sign2' => '2ca3abe86d90c6142d5571db98af6714',
'url' => 'https://www.keycaptcha.ru/demo-magnetic/',
]);
Oparta na tokenach metoda ominięcia Capy puzzle captcha.
$result = $solver->capy([
'sitekey' => 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
'url' => 'http://mysite.com/',
'api_server' => 'https://jp.api.capy.me/',
]);
Metoda siatki jest pierwotnie nazywana starą metodą reCAPTCHA V2. Metodę można wykorzystać do pominięcia dowolnego typu captcha, w którym można zastosować siatkę do obrazu i kliknąć określone pola siatki. Zwraca numery pudełek.
$result = $solver->grid('path/to/captcha.jpg');
Metodę Canvas można zastosować, gdy trzeba narysować linię wokół obiektu na obrazie. Zwraca zestaw współrzędnych punktów do narysowania wielokąta.
$result = $solver->canvas('path/to/captcha.jpg');
Metoda ClickCaptcha zwraca współrzędne punktów na obrazie captcha. Może być użyty, jeśli musisz kliknąć w określone punkty na obrazie.
$result = $solver->coordinates('path/to/captcha.jpg');
Tej metody można użyć do rozwiązania captcha, które prosi o obrócenie obiektu. Używany głównie do ominięcia FunCaptcha. Zwraca kąt obrotu.
$result = $solver->rotate('path/to/captcha.jpg');
Inne metody
Dodatkowe poprawne metody stosowane podczas pracy nad głównymi skryptami
send / getResult
Te metody mogą być używane do ręcznego przesyłania captcha i odpytywania odpowiedzi.
$id = $solver->send(['file' => 'path/to/captcha.jpg', ...]);
sleep(20);
$code = $solver->getResult($id);
balance
Użyj tej metody, aby uzyskać saldo swojego konta.
$balance = $solver->balance();
report
Użyj tej metody, aby zgłosić dobrą lub złą odpowiedź captcha.
$solver->report($id, true); // captcha solved correctly
$solver->report($id, false); // captcha solved incorrectly
Obsługa błędów
Możliwe warianty standardowych błędów zwracanych przez usługę podczas przetwarzania żądań
W przypadku błędu solver captcha zgłasza wyjątek. Ważne jest, aby właściwie obsługiwać takie przypadki. Zalecamy użycie try/catch
do obsługi wyjątków.
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
}