Bypassa i captcha con PHP
Integra il pacchetto PHP per bypassare automaticamente i captcha. Ha il tasso migliore di successo per il riconoscimento di captcha.
Il pacchetto PHP per integrare facilmente l'API di 2Captcha il servizio di risoluzione captcha per bypassare reCAPTCHA, Arkose captcha, Geetest e risolvere tutti gli altri tipi di captcha.
Avvio rapidoInstallazione
Il pacchetto di script può essere installato manualmente o usando il programma di installazione del pacchetto
Composer
Per installare automaticamente un pacchetto di librerie, devi usare una soluzione standard per i pacchetti PHP - Composer. Scaricala dal link e installala seguendo le istruzioni. Dopo aver installato l'applicazione, usa il comando:
composer require 2captcha/2captcha
Manuale
Scarica i contenuti della cartella src
e attiva l'autoloader src/autoloader.php
con il comando:
require 'path/to/autoloader.php';
Vi invitiamo ad esplorare il nostro archivio GitHub nel quale potrete trovare le librerie e i moduli per integrare facilmente il nostro API.
Configurazione
Descrizione di tutti i parametri necessari per configurare il pacchetto installato
Un'istanza dell'ordine di TwoCaptcha
può essere creata in questo modo:
$solver = new \TwoCaptcha\TwoCaptcha('YOUR_API_KEY');
Hai anche la possibilità di personalizzare alcune delle opzioni per l'istanza:
$solver = new \TwoCaptcha\TwoCaptcha([
'apiKey' => 'YOUR_API_KEY',
'softId' => 123,
'callback' => 'https://your.site/result-receiver',
'defaultTimeout' => 120,
'recaptchaTimeout' => 600,
'pollingInterval' => 10,
]);
Opzioni per istanza TwoCaptcha
Opzione | Valore di default | Descrizione |
---|---|---|
softId | - | l'ID del tuo software è stata ottenuta dopo aver pubblicato su 2Captcha software catalog |
callback | - | L'URL del tuo server che riceve il risultato del riconoscimento captcha. L'URL dovrebbe venire registrato sul tuo account nella sezione impostazioni pingback |
defaultTimeout | 120 | Timeout in secondi per tutti i tipi di captcha eccetto i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API res.php |
recaptchaTimeout | 600 | Timeout in secondi per i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API res.php |
pollingInterval | 10 | Intervallo in secondi tra le richieste al terminale API res.php . Impostare un valore minore a 5 secondi non è consigliato |
IMPORTANTE: una volta che ilcallback
viene creato per l'istanzaTwoCaptcha
, tutti i metodi rimandano solo l'ID del captcha e NON interpellano l'API per avere il risultato. I risultati verranno mandati all'URL del callback. Per ricere le risposte manualmente usare getResult method
Risolvere i captcha
Quando invii qualsiasi captcha con un'immagine, puoi fornire opzioni aggiuntive per aiutare gli operatori di 2Captcha a risolverlo correttamente
Opzioni captcha
Opzione | valore di default | Descrizione |
---|---|---|
numeric | 0 | Definisce se il captcha contiene nnumeri o altri simboli a href='/2captcha-api#normal_post'>scopri di più sul documento API |
minLength | 0 | Lunghezza minima della risposta |
maxLength | 0 | Lunghezza massima della risposta |
phrase | 0 | definisce se la risposta contiene più parole o no |
caseSensitive | 0 | definisce se la risposta distingue le maiuscole dalle minuscole |
calc | 0 | definisce se il captcha necessita di un calcolo |
lang | - | definisce il linguaggio del captcha, guarda la lista dei linguaggi supportati |
hintImg | - | un'immagine con il suggerimento mostrata agli operatori con il captcha |
hintText | - | suggerimento o testo mostrato agli operatori con il captcha |
- Normal Captcha
- Text Captcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- KeyCaptcha
- Capy
- Grid
- Canvas
- ClickCaptcha
- Rotate
Per bypassare un normal captcha (testo distorto in un'immagine) usa il metodo seguente. QUesta modalità può venire utilizzata anche per riconoscere il testo nell'immagine
$result = $solver->normal('path/to/captcha.jpg');
Questo metodo può essere usato per bypassare un captcha che richiede di rispondere ad una domanda di testo.
$result = $solver->text('If tomorrow is Saturday, what day is today?');
Usa questo metodo per risolvere i reCAPTCHA V2 e ottenere il token per bypassare la protezione.
$result = $solver->recaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/recaptcha',
]);
Questo metodo permette di risolvere il reCAPTCHA V3 e ricevere il token.
$result = $solver->recaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/recaptcha',
'version' => 'v3',
]);
Metodo per risolvere FunCaptcha (Arkoselabs). In cambio viene dato un token.
$result = $solver->funcaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/funcaptcha',
]);
Metodo per risolvere un captcha puzzle GeeTest. In cambio viene dato un set di token come JSON.
$result = $solver->geetest([
'gt' => 'f1ab2cdefa3456789012345b6c78d90e',
'challenge' => '12345678abc90123d45678ef90123a456b',
'url' => 'https://www.site.com/page/',
]);
Metodo basato su token per risolvere i 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/',
]);
Metodo basato su token per bypassare i captcha Capy Puzzle.
$result = $solver->capy([
'sitekey' => 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
'url' => 'http://mysite.com/',
'api_server' => 'https://jp.api.capy.me/',
]);
Il metodo Grid era in origine chiamato il metodo per i vecchi reCAPTCHA V2. Può essere usato per bypassare qualsiasi tipo di captcha nel quale bisogna applicare una griglia ad un'immagine e cliccare su specifiche sezioni di essa. In cambio vengono dati i numeri delle sezioni.
$result = $solver->grid('path/to/captcha.jpg');
Il metodo canvas può essere usato quando bisogna disegnare una linea intorno ad un oggetto o un'immagine. Riporta un set di coordinate di punti per disegnare un poligono.
$result = $solver->canvas('path/to/captcha.jpg');
Il metodo clickCaptcha riporta le coordinate di alcuni punti sull'immagine del captcha. Può essere usato se c'è bisogno di cliccaresu un particolare punto dell'immagine.
$result = $solver->coordinates('path/to/captcha.jpg');
Questo metodo può essere usato per risolvere un captcha che richiede di girare un oggetto. Viene usato principalmente per ricolvere i FunCaptcha. Riporta l'angolo di rotazione.
$result = $solver->rotate('path/to/captcha.jpg');
Altre modalità
Ulteriori metodi validi usati durante il lavoro degli script principali
send / getResult
Queste modalità possono essere utilizzate per inserire il captcha manualmente e rispondere ai sondaggi.
$id = $solver->send(['file' => 'path/to/captcha.jpg', ...]);
sleep(20);
$code = $solver->getResult($id);
balance
Usa questa modalità per accedere al saldo del tuo conto.
$balance = $solver->balance();
report
Usa questa modalità per segnalare una risposta captcha giusta o sbagliata.
$solver->report($id, true); // captcha solved correctly
$solver->report($id, false); // captcha solved incorrectly
Gestione degli errori
Possibili varianti di errori standard sperimentato dal servizio mentre processa le richieste
Nel caso in cui un risolutore di captcha si trovi davanti ad un errore, manda un segnale di eccezione. È importante gestire bene questi casi. Si raccomanda di usare try/catch
per gestire le eccezioni.
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
}
Altri linguaggi per l'integrazione con il servizio API
Pacchetto Python per l'integrazione con il service API
Pacchetto Java per l'integrazione con il service API
Pacchetto C# per l'integrazione con il service API
Pacchetto Golang per l'integrazione con il service API
Pacchetto Ruby per l'integrazione con il service API
Pacchetto JavaScript per l'integrazione con il service API