Omitir captcha con PHP
Integre el paquete PHP para evitar la solución de automatización de captcha. Mejor tasa de reconocimiento de captcha exitosa.
Paquete PHP para una fácil integración con la API del servicio de resolución de captcha 2Captcha para omitir reCAPTCHA, Arkose captcha, geetest y resuelve cualquier otro captchas
Inicio rápidoInstalación
El paquete de secuencias de comandos se puede instalar usando el instalador de paquetes o manualmente
Compositora
Para instalar automáticamente un paquete de bibliotecas, debe usar la solución estándar para paquetes de PHP: Composer. Descárguelo del enlace e instálelo según las instrucciones. Después de instalar la aplicación, use el comando:
composer require 2captcha/2captcha
Manual
Descarga el contenido de la carpeta src
a tu proyecto y activa el cargador automático src/autoloader.php
con el comando:
require 'path/to/autoloader.php';
Te invitamos a explorar nuestro repositorio GitHub donde puedes encontrar bibliotecas y módulos para fácil integración con nuestra API.
Configuración
Descripción de todos los parámetros necesarios para configurar el paquete instalado
Una instancia de la clase TwoCaptcha
se puede crear así:
$solver = new \TwoCaptcha\TwoCaptcha('YOUR_API_KEY');
También tiene la posibilidad de personalizar algunas de las opciones para la instancia creada:
$solver = new \TwoCaptcha\TwoCaptcha([
'apiKey' => 'YOUR_API_KEY',
'softId' => 123,
'callback' => 'https://your.site/result-receiver',
'defaultTimeout' => 120,
'recaptchaTimeout' => 600,
'pollingInterval' => 10,
]);
Opciones de instancia de TwoCaptcha
Opción | Valor por defecto | Descripción |
---|---|---|
softId | - | su ID de software obtenido después de publicarlo en el 2Captcha catálogo de software |
llamar de vuelta | - | URL de su servidor web que recibe el resultado del reconocimiento de captcha. La URL debe registrarse primero en configuración de pingback de su cuenta |
tiempo de espera predeterminado | 120 | Tiempo de espera de sondeo en segundos para todos los tipos de captcha excepto reCAPTCHA. Define cuánto tiempo el módulo intenta obtener la respuesta desde el extremo de la API res.php |
recaptchaTiempo de espera | 600 | Tiempo de espera de sondeo para reCAPTCHA en segundos. Define cuánto tiempo el módulo intenta obtener la respuesta desde el extremo de la API res.php |
intervalo de votación | 10 | Intervalo en segundos entre las solicitudes al punto final de la API res.php ; no se recomienda establecer valores inferiores a 5 segundos |
IMPORTANTE: una vez quedevolución de llamada
se define para la instancia deTwoCaptcha
, todos los métodos devuelven solo el ID de captcha y DO NO sondee la API para obtener el resultado. El resultado se enviará a la URL de devolución de llamada. Para obtener la respuesta manualmente, use el método getResult
Resolver Captcha
Cuando envía cualquier captcha basado en imágenes, el uso puede proporcionar opciones adicionales para ayudar a los trabajadores de 2Captcha a resolverlo correctamente
Opciones de captcha
opción | Valor por defecto | Descripción |
---|---|---|
numeric | 0 | Define si el captcha contiene símbolos numéricos u otros ver más información en los documentos API |
minLength | 0 | longitud mínima de respuesta |
maxLength | 0 | longitud máxima de respuesta |
phrase | 0 | define si la respuesta contiene varias palabras o no |
caseSensitive | 0 | define si la respuesta es sensible a mayúsculas y minúsculas |
calc | 0 | define captcha requiere cálculo |
lang | - | define el idioma captcha, consulte la lista de idiomas admitidos |
hintImg | - | Una imagen con pista mostrada a los trabajadores con el captcha. |
hintText | - | sugerencia o texto de tarea que se muestra a los trabajadores con el captcha |
- Captcha normal
- Captcha de texto
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- claveCaptcha
- Capy
- Cuadrícula
- Can
- clickCaptcha
- girar
Para omitir un captcha normal (texto distorsionado en la imagen), use el siguiente método. Este método también se puede utilizar para reconocer cualquier texto en la imagen.
$result = $solver->normal('path/to/captcha.jpg');
Este método se puede usar para omitir un captcha que requiere responder una pregunta proporcionada en texto claro.
Utilice este método para resolver reCAPTCHA V2 y obtener un token para eludir la protección.
$result = $solver->recaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/recaptcha',
]);
Este método proporciona el solucionador reCAPTCHA V3 y devuelve un token.
$result = $solver->recaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/recaptcha',
'version' => 'v3',
]);
Método de resolución FunCaptcha (Arkoselabs). Devuelve una ficha.
$result = $solver->funcaptcha([
'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
'url' => 'https://mysite.com/page/with/funcaptcha',
]);
Método para resolver el captcha del rompecabezas GeeTest. Devuelve un conjunto de tokens como JSON.
$result = $solver->geetest([
'gt' => 'f1ab2cdefa3456789012345b6c78d90e',
'challenge' => '12345678abc90123d45678ef90123a456b',
'url' => 'https://www.site.com/page/',
]);
Método basado en token para resolver KeyCaptcha.
Método basado en tokens para eludir el captcha del rompecabezas de Capy.
$result = $solver->capy([
'sitekey' => 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
'url' => 'http://mysite.com/',
'api_server' => 'https://jp.api.capy.me/',
]);
El método de cuadrícula se llama originalmente método Old reCAPTCHA V2. El método se puede usar para omitir cualquier tipo de captcha donde puede aplicar una cuadrícula en la imagen y necesita hacer clic en cuadros de cuadrícula específicos. Devuelve números de cajas.
El método de lienzo se puede usar cuando necesita dibujar una línea alrededor de un objeto en la imagen. Devuelve un conjunto de coordenadas de puntos para dibujar un polígono.
$result = $solver->canvas('path/to/captcha.jpg');
El método ClickCaptcha devuelve las coordenadas de los puntos en la imagen captcha. Se puede usar si necesita hacer clic en puntos particulares de la imagen.
Este método se puede usar para resolver un captcha que pide rotar un objeto. Se utiliza principalmente para eludir FunCaptcha. Devuelve el ángulo de rotación.
$result = $solver->rotate('path/to/captcha.jpg');
Otros metodos
Métodos válidos adicionales utilizados durante el trabajo de los guiones principales
send / getResult
Estos métodos se pueden utilizar para el envío manual de captchas y encuestas de respuesta.
$id = $solver->send(['file' => 'path/to/captcha.jpg', ...]);
sleep(20);
$code = $solver->getResult($id);
balance
Utilice este método para obtener el saldo de su cuenta.
$balance = $solver->balance();
report
Use este método para informar una respuesta de captcha buena o mala.
$solver->report($id, true); // captcha solved correctly
$solver->report($id, false); // captcha solved incorrectly
Manejo de errores
Posibles variantes de errores estándar devueltos por el servicio al procesar solicitudes
Si se produce un error, el solucionador de captcha arroja una excepción. Es importante manejar adecuadamente estos casos. Recomendamos usar try/catch
para manejar las excepciones.
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
}
Otros idiomas para la integración con la API del servicio
Paquete Python para la integración con la API del servicio
Paquete Java para la integración con la API del servicio
Paquete C# para la integración con la API del servicio
Paquete Golang para la integración con la API del servicio
Paquete Ruby para la integración con la API del servicio
Paquete JavaScript para la integración con la API del servicio