
Rajinder Singh
Deep Learning Researcher
प्रकाशित Nov 19, 2026
अद्यतन Nov 19, 2026 · मिनट पढ़ने का समय

ImageToTextTask के साथ एक लोकल इमेज CAPTCHA पढ़ता है; यह task अपना परिणाम सीधे createTask से लौटाता है।errorId दोनों जाँचें, फिर उपयोग से पहले solution.text को वैलिडेट करें।CAPTCHA सॉल्वर Laravel एप्लिकेशन को किसी अधिकृत वर्कफ़्लो में समर्थित चैलेंज को हैंडल करने के लिए एक सर्वर‑साइड स्टेप देता है। Laravel एक PHP वेब एप्लिकेशन फ़्रेमवर्क है: यह एप्लिकेशन कोड, कंसोल कमांड और बैकग्राउंड कार्य चला सकता है। इसका HTTP क्लाइंट API रिक्वेस्ट भेजता है; यह न तो ब्राउज़र पेज रेंडर करता है और न ही CAPTCHA विजेट चलाता है।
उदाहरण के लिए, एक आंतरिक ऑपरेशन्स टूल को किसी अनुमोदित डॉक्यूमेंट रिट्रीवल टास्क के दौरान इमेज चैलेंज मिल सकता है। एप्लिकेशन इमेज को सॉल्वर को भेजता है, लौटे हुए टेक्स्ट की जाँच करता है और फिर उस उत्तर को अपनी मौजूदा वर्कफ़्लो के संबंधित स्टेप को पास कर देता है। सेशन हैंडलिंग, परिणाम वैलिडेशन और आगे बढ़ने का निर्णय अभी भी एप्लिकेशन के पास ही रहता है।
यह गाइड CapSolver को Laravel के नैटिव HTTP क्लाइंट के साथ उपयोग करता है। उदाहरण एक ओन्ड लोकल टेस्ट इमेज को पहचानने पर रुक जाता है, ताकि रिक्वेस्ट और परिणाम को किसी बड़े एप्लिकेशन से जोड़ने से पहले आसानी से देखा जा सके। यह आपके अपने फ़ॉर्म पर CAPTCHA प्रोटेक्शन इंस्टॉल करने की गाइड नहीं है।
एक काम कर रहे Laravel एप्लिकेशन, उपलब्ध बैलेंस वाला CapSolver अकाउंट, और आपके स्वामित्व या अधिकृत एक लोकल PNG या JPEG इमेज से शुरू करें। नीचे दिए कमांड के लिए इमेज को storage/app/fixture.png पर रखें। ऐसा साधारण टेक्स्ट इमेज चुनें जिसका अपेक्षित उत्तर आप स्वयं जाँच सकें।
कमांड्स को अपने Laravel प्रोजेक्ट रूट से चलाएँ। इंटीग्रेशन फ्रेमवर्क के HTTP क्लाइंट का उपयोग करता है, इसलिए कोई अलग solver SDK आवश्यक नहीं है। PHP को API के लिए verified HTTPS कनेक्शन स्थापित करने में सक्षम होना चाहिए।
यहाँ जो task उपयोग हो रहा है वह है ImageToTextTask। इसका body इमेज के Base64 डेटा को रखता है, बिना data-URI प्रीफ़िक्स के। common मॉड्यूल पहचान किया हुआ टेक्स्ट लौटाता है। असिंक्रोनस task फ्लो से अलग, यह रिकग्निशन task अपना परिणाम createTask के रिस्पॉन्स में ही देता है; उदाहरण getTaskResult को पोल नहीं करता।
API key को एप्लिकेशन की environment फ़ाइल में रखें और उसे कॉन्फ़िगरेशन फ़ाइल के ज़रिए एक्सपोज़ करें। अपनी सर्वर की .env फ़ाइल में यह एंट्री जोड़ें और लोकल रूप से placeholder बदलें:
CAPSOLVER_API_KEY=YOUR_CAPSOLVER_API_KEY
config/capsolver.php बनाएँ:
<?php
return ['api_key' => env('CAPSOLVER_API_KEY')];
कमांड config('capsolver.api_key') पढ़ेगा। Laravel की कॉन्फ़िगरेशन गाइडेंस यह समझाती है कि environment वैल्यूज़ को विशेष रूप से कैश की गई कॉन्फ़िगरेशन के समय कॉन्फ़िगरेशन फ़ाइलों में क्यों रखना चाहिए। यदि आपका deployment कॉन्फ़िगरेशन कैश का उपयोग करता है, तो key बदलने के बाद अपनी सामान्य deployment प्रक्रिया के माध्यम से उसे दोबारा बनाएँ।
.env को version control से बाहर रखें और key को frontend JavaScript तक न पहुँचाएँ। आउटबाउंड रिक्वेस्ट बॉडी को लॉग करने से बचें: उसका clientKey फ़ील्ड एक credential है, और उसका image फ़ील्ड ऐसा डेटा रख सकता है जिसे आप सामान्य एप्लिकेशन लॉग्स में नहीं देखना चाहते।
निम्न closure कमांड को routes/console.php में जोड़ें, साथ ही पहले से मौजूद किसी अन्य कमांड को यथावत रखें। Laravel closure‑based Artisan commands को सपोर्ट करता है; इससे पहली इंटीग्रेशन इतनी छोटी रहती है कि उसे सीधे चला और जाँचा जा सके।
कमांड लोकल इनपुट को वैलिडेट करता है, एक रिक्वेस्ट भेजता है, और केवल तभी nonempty टेक्स्ट परिणाम प्रिंट करता है जब रिस्पॉन्स चेक पास हो जाते हैं। इसका PNG/JPEG प्रतिबंध और timeout वैल्यूज़ उदाहरण एप्लिकेशन विकल्प हैं, न कि विक्रेता सीमाओं की पूरी सूची।
<?php
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\Http;
use Illuminate\Http\Client\ConnectionException;
Artisan::command('captcha:read {path}', function () {
$key = config('capsolver.api_key');
$path = $this->argument('path');
if (! is_string($key) || $key === '') {
$this->error('Set CAPSOLVER_API_KEY on the server.');
return 1;
}
if (! is_file($path) || ! is_readable($path)) {
$this->error('Supply a readable local image file.');
return 1;
}
if (! in_array(mime_content_type($path), ['image/png', 'image/jpeg'], true)) {
$this->error('This example accepts PNG and JPEG files.');
return 1;
}
$image = file_get_contents($path);
if ($image === false) {
$this->error('Could not read the image.');
return 1;
}
try {
$response = Http::acceptJson()->connectTimeout(10)->timeout(60)
->post('https://api.capsolver.com/createTask', [
'clientKey' => $key,
'task' => [
'type' => 'ImageToTextTask',
'module' => 'common',
'body' => base64_encode($image),
],
]);
} catch (ConnectionException $exception) {
$this->error('Connection failed or timed out. Check before resubmitting.');
return 1;
}
if (! $response->successful()) {
$this->error('Solver HTTP error: '.$response->status());
return 1;
}
$data = $response->json();
if (! is_array($data) || ($data['errorId'] ?? null) !== 0) {
$this->error('Solver API error: '.($data['errorCode'] ?? 'INVALID_RESPONSE'));
return 1;
}
$text = $data['solution']['text'] ?? null;
if (($data['status'] ?? null) !== 'ready' || ! is_string($text) || $text === '') {
$this->error('No ready text result was returned.');
return 1;
}
$this->line($text);
return 0;
})->purpose('Read an authorized image CAPTCHA with the solver API');
HTTP‑status चेक महत्वपूर्ण है क्योंकि Laravel हर HTTP error रिस्पॉन्स के लिए अपने‑आप exception नहीं फेंकता। API‑लेवल चेक अलग है: सफल HTTP रिस्पॉन्स में भी अपेक्षित errorId, task स्टेटस और result फ़ील्ड होना ज़रूरी है।
कमांड जानबूझकर task‑creation के ऑटोमैटिक retry से बचता है। कनेक्शन timeout आपको यह अनिश्चितता दे सकता है कि सेवा ने मूल रिक्वेस्ट प्राप्त की थी या नहीं। विशेष रूप से जब आप ऑपरेशन को किसी ऐसी queue में ले जाते हैं जिसका अपना retry पॉलिसी है, फिर से सबमिट करने से पहले फ़ेल्यर की जाँच करें।
अपना CapSolver बोनस कोड रिडीम करें
अपने ऑटोमेशन बजट को तुरंत बढ़ाएँ!
CapSolver अकाउंट रिचार्ज करते समय बोनस कोड CAP26 का उपयोग करें और हर रिचार्ज पर अतिरिक्त 5% बोनस पाएँ — बिना किसी सीमा के।
इसे अभी अपने CapSolver Dashboard में रिडीम करें।
कमांड को एक बार अपनी लोकल फ़िक्स्चर पर चलाएँ:
php artisan captcha:read storage/app/fixture.png
यदि इमेज में 583729 है, तो अपेक्षित आउटपुट होगा:
583729
लौटे हुए टेक्स्ट को वास्तविक इमेज से तुलना करें, अक्षरों के केस और संदिग्ध कैरेक्टर सहित। nonempty स्ट्रिंग यह साबित करती है कि रिक्वेस्ट ने परिणाम दिया; यह हर भविष्य की इमेज के लिए सटीकता स्थापित नहीं करती। जब आप इस स्टेप को किसी अनुमति‑प्राप्त एप्लिकेशन वर्कफ़्लो से जोड़ें, तो गंतव्य की acceptance रिस्पॉन्स को अलग चेक के रूप में उपयोग करें।
यदि PHP कोई certificate‑file या trust‑store error रिपोर्ट करे, तो दोबारा प्रयास करने से पहले उस runtime के लिए कॉन्फ़िगर किए गए CA bundle को ठीक करें। TLS certificate वैरिफ़िकेशन सक्षम रखें। कमांड का connection‑error संदेश जानबूझकर संक्षिप्त है; credentials या रिक्वेस्ट बॉडी को डंप किए बिना इन्फ़्रास्ट्रक्चर डायग्नॉस्टिक्स को अलग से जाँचें।
इनपुट फ़ेल्यर, ट्रांसपोर्ट फ़ेल्यर, API errors और downstream rejection को अलग‑अलग परिणामों के रूप में रखें। यह अंतर एक missing फ़ाइल को paid API retry बनने से रोकता है और एप्लिकेशन वैलिडेशन error को solver outage के रूप में गिने जाने से बचाता है।
| परिणाम | अगला कदम |
|---|---|
| API key गायब है | रिक्वेस्ट करने से पहले सर्वर कॉन्फ़िगरेशन ठीक करें |
| फ़ाइल गायब है या इस उदाहरण द्वारा असमर्थित है | इनपुट ठीक करें; किसी solver रिक्वेस्ट की ज़रूरत नहीं |
| कनेक्शन फ़ेल या timeout | नेटवर्क और TLS कॉन्फ़िगरेशन जाँचें; दोबारा भेजने से पहले पुष्टि करें |
| HTTP या API error | status या error code लॉग करें और संबंधित API गाइडेंस का पालन करें |
| टेक्स्ट मिला | उसे इमेज से मिलाएँ और अगले एप्लिकेशन स्टेप को वैलिडेट करें |
जब आप इस कमांड को queue जॉब में बदलें, तो secrets को serialized जॉब payload से बाहर रखें और execution के समय उन्हें कॉन्फ़िगरेशन से पढ़ें। जॉब की retry behavior को स्पष्ट रूप से परिभाषित करें। जब आप यह स्थापित नहीं कर सकें कि परिणाम स्वीकार किया गया था, तो कॉलिंग वर्कफ़्लो को “unresolved” परिणाम लौटा दें।
विस्तृत ऑपरेशनल troubleshooting के लिए हमारा dynamic DNS proxy error explanation एक अलग सेशन‑संबंधित फ़ेल्यर समझाता है। वह उदाहरण proxy consistency से जुड़ा है, इमेज रिकग्निशन से नहीं; उसके task पैरामीटर इस कमांड पर लागू न करें।
हर CAPTCHA को इमेज‑रिकग्निशन endpoint पर भेजने के बजाय, आपके पास जो वास्तविक चैलेंज है उसके आधार पर task चुनें। इमेज‑to‑टेक्स्ट परिणाम एक स्ट्रिंग होता है। यह reCAPTCHA या Turnstile इंटीग्रेशन द्वारा अपेक्षित टोकन की जगह नहीं ले सकता।
समर्थित API task टाइप का उपयोग करके प्रासंगिक contract पहचानें। ब्राउज़र execution, विजेट पैरामीटर और गंतव्य submission अलग‑अलग ज़िम्मेदारियाँ रहती हैं। पहले छोटा इमेज वर्कफ़्लो पूरा करें, फिर वह विशिष्ट समर्थित task बनाएँ और टेस्ट करें जिसकी आपके एप्लिकेशन को ज़रूरत है।
Laravel का नैटिव HTTP क्लाइंट छोटे, inspectable solver इंटीग्रेशन के लिए पर्याप्त है। रिक्वेस्ट को सर्वर‑साइड रखें, डोक्यूमेंटेड task schema का उपयोग करें, और परिणाम तथा अगले एप्लिकेशन स्टेप दोनों को वैलिडेट करें। इसके बाद CapSolver अधिकृत वर्कफ़्लो के CAPTCHA स्टेप पर बैठ सकता है, बिना बाकी एप्लिकेशन पर कब्ज़ा किए।
प्र: क्या मुझे Laravel CAPTCHA solver पैकेज की ज़रूरत है?
नहीं। यह उदाहरण Laravel के बिल्ट‑इन HTTP क्लाइंट का उपयोग करके सीधे API को कॉल करता है। अलग रैपर वैकल्पिक है और उपयोग से पहले उसे मौजूदा task contract के अनुरूप जाँचना चाहिए।
प्र: क्या यह मेरे Laravel लॉगिन फ़ॉर्म पर CAPTCHA प्रोटेक्शन जोड़ देता है?
नहीं। यह कमांड solver API के ज़रिए अधिकृत इमेज चैलेंज को पहचानता है। अपने फ़ॉर्म में CAPTCHA प्रोटेक्शन जोड़ना CAPTCHA प्रदाता की validation सेवा के साथ एक अलग इंटीग्रेशन है।
प्र: क्या मुझे इस उदाहरण के लिए getTaskResult को पोल करना होगा?
नहीं। ImageToTextTask अपना रिकग्निशन परिणाम सीधे createTask से लौटाता है। अन्य task टाइप के लिए रिज़ल्ट फ्लो अलग हो सकता है, इसलिए चुने हुए task की डोक्यूमेंटेशन का पालन करें।
प्र: क्या यह कोड reCAPTCHA या Turnstile को ज्यों का त्यों हल कर सकता है?
नहीं। यह कोड ImageToTextTask भेजता है और टेक्स्ट की अपेक्षा करता है। reCAPTCHA और Turnstile अलग task पैरामीटर और टोकन परिणाम उपयोग करते हैं; केवल task नाम बदलना पर्याप्त नहीं है।
प्र: क्या मुझे timeout के बाद अपने‑आप retry करना चाहिए?
उसी task को बिना सोचे‑समझे दोबारा न बनाएँ। timeout रिक्वेस्ट सेवा तक पहुँचने के बाद भी हो सकता है, इसलिए फ़ेल्यर की जाँच करें और ऑटोमैटिक retries जोड़ने से पहले bounded retry पॉलिसी परिभाषित करें।

Rajinder Singh
Deep Learning Researcher
Making CAPTCHA solving more reliable in automated workflows.
लेखक के बारे में
नियंत्रित इमेज परीक्षण, वास्तविक API परिणामों और फ़ॉर्म स्वीकृति जांच के साथ हेडलेस और हेडेड CAPTCHA वर्कफ़्लो की तुलना करें। जानें कि परिणाम क्या साबित करते हैं।

Cypress में एक Node टास्क के साथ CAPTCHA सॉल्वर जोड़ें, API कुंजियों को ब्राउज़र कोड से बाहर रखें, और एक परखे हुए JavaScript उदाहरण के साथ आपके स्वामित्व वाले इमेज-CAPTCHA फ़ॉर्म को सत्यापित करें।
