
Emma Foster
Machine Learning Engineer
Diterbitkan Nov 19, 2026
Diperbarui Nov 19, 2026 · min baca

ImageToTextTask; task tersebut mengembalikan hasil pengenalan langsung dari createTask.errorId dari API, lalu validasi solution.text sebelum menggunakannya.Solver CAPTCHA memberi aplikasi Laravel sebuah langkah sisi server untuk menangani challenge yang didukung dalam alur kerja yang terotorisasi. Laravel adalah framework aplikasi web PHP: ia dapat menjalankan kode aplikasi, perintah konsol, dan pekerjaan latar belakang. HTTP client‑nya mengirim permintaan API; ia tidak merender halaman browser atau mengoperasikan widget CAPTCHA.
Sebagai contoh, sebuah tool operasi internal mungkin menerima image challenge saat tugas pengambilan dokumen yang telah disetujui. Aplikasi mengirim gambar ke solver, memeriksa teks yang dikembalikan, dan meneruskan jawaban tersebut ke langkah terkait dalam alur kerja yang sudah ada. Aplikasi tetap memiliki kendali atas penanganan sesi, validasi hasil, dan keputusan untuk melanjutkan.
Panduan ini menggunakan CapSolver dengan HTTP client bawaan Laravel. Contohnya berhenti pada pengenalan gambar uji lokal milik sendiri, sehingga permintaan dan hasilnya mudah diperiksa sebelum dihubungkan ke aplikasi yang lebih besar. Ini bukan panduan memasang proteksi CAPTCHA pada form Anda sendiri.
Mulailah dengan aplikasi Laravel yang sudah berjalan, akun CapSolver dengan saldo yang tersedia, dan gambar PNG atau JPEG lokal yang Anda miliki atau berwenang untuk memprosesnya. Letakkan gambar di storage/app/fixture.png untuk perintah di bawah. Pilih gambar teks sederhana dengan jawaban yang bisa Anda periksa sendiri.
Jalankan perintah dari root proyek Laravel Anda. Integrasi ini menggunakan HTTP client milik framework, jadi tidak diperlukan SDK solver terpisah. PHP harus dapat membuat koneksi HTTPS terverifikasi ke API.
Task yang digunakan di sini adalah ImageToTextTask. body‑nya berisi data Base64 dari gambar, tanpa prefiks data-URI. Modul common mengembalikan teks yang dikenali. Berbeda dengan alur task asinkron, task pengenalan ini mengembalikan hasilnya di respons createTask; contoh ini tidak melakukan polling ke getTaskResult.
Simpan API key di environment aplikasi dan ekspose melalui berkas konfigurasi. Tambahkan entri ini ke .env di server Anda, ganti placeholder secara lokal:
CAPSOLVER_API_KEY=YOUR_CAPSOLVER_API_KEY
Buat config/capsolver.php:
<?php
return ['api_key' => env('CAPSOLVER_API_KEY')];
Perintah akan membaca config('capsolver.api_key'). Panduan konfigurasi Laravel menjelaskan mengapa nilai environment ditempatkan di berkas konfigurasi, terutama ketika konfigurasi di-cache. Jika deployment Anda menggunakan cache konfigurasi, bangun ulang melalui proses deployment normal setelah mengubah key.
Jauhkan .env dari version control dan jangan meneruskan key ke JavaScript frontend. Hindari melakukan logging pada request body yang dikirim: field clientKey adalah kredensial, dan field gambar dapat berisi data yang tidak ingin Anda simpan di log aplikasi umum.
Tambahkan closure command berikut ke routes/console.php, dengan tetap mempertahankan perintah lain yang sudah ada di berkas tersebut. Laravel mendukung perintah Artisan berbasis closure; ini membuat integrasi pertama cukup kecil untuk dijalankan dan diperiksa secara langsung.
Perintah ini memvalidasi input lokal, mengirim satu permintaan, dan hanya mencetak hasil teks yang tidak kosong setelah pemeriksaan respons lolos. Pembatasan PNG/JPEG dan nilai timeout adalah pilihan contoh aplikasi, bukan daftar lengkap batasan vendor.
<?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');
Pemeriksaan status HTTP penting karena Laravel tidak otomatis melempar exception untuk setiap respons HTTP error. Pemeriksaan di tingkat API terpisah: respons HTTP yang sukses tetap harus berisi errorId, status task, dan field hasil yang diharapkan.
Perintah ini dengan sengaja menghindari retry otomatis saat membuat task. Timeout koneksi dapat membuat Anda tidak yakin apakah layanan telah menerima permintaan asli. Periksa kegagalan sebelum mengirim ulang, khususnya saat memindahkan operasi ke queue yang memiliki kebijakan retry sendiri.
Tukarkan Kode Bonus CapSolver Anda
Tambahkan anggaran automasi Anda secara instan!
Gunakan kode bonus CAP26 saat mengisi saldo akun CapSolver Anda untuk mendapatkan bonus 5% di setiap pengisian — tanpa batas.
Tukarkan sekarang di Dashboard CapSolver
Jalankan perintah sekali terhadap fixture lokal Anda:
php artisan captcha:read storage/app/fixture.png
Untuk gambar yang berisi 583729, output yang diharapkan adalah:
583729
Bandingkan teks yang dikembalikan dengan gambar asli, termasuk huruf besar/kecil dan karakter yang ambigu. String tidak kosong membuktikan bahwa permintaan menghasilkan sebuah hasil; ini tidak menjamin akurasi untuk setiap gambar di masa mendatang. Gunakan respons penerimaan dari tujuan akhir sebagai pemeriksaan terpisah ketika Anda menghubungkan langkah ini ke alur kerja aplikasi yang diizinkan.
Jika PHP melaporkan kesalahan berkas sertifikat atau trust store, perbaiki bundel CA yang dikonfigurasi untuk runtime tersebut sebelum mencoba lagi. Biarkan verifikasi sertifikat TLS tetap aktif. Pesan error koneksi perintah ini sengaja dibuat singkat; selidiki diagnostik infrastruktur secara terpisah tanpa mencetak kredensial atau body permintaan.
Bedakan antara kegagalan input, kegagalan transport, error API, dan penolakan dari sistem tujuan. Pembedaan ini mencegah berkas yang hilang menjadi retry API berbayar dan mencegah error validasi aplikasi dihitung sebagai outage solver.
| Hasil | Tindakan berikutnya |
|---|---|
| API key hilang | Perbaiki konfigurasi server sebelum membuat permintaan |
| Berkas hilang atau tidak didukung oleh contoh ini | Perbaiki input; tidak perlu permintaan ke solver |
| Koneksi gagal atau timeout | Periksa konfigurasi jaringan dan TLS; cek sebelum mengirim ulang |
| Error HTTP atau API | Catat status atau kode error dan ikuti panduan API yang relevan |
| Teks dikembalikan | Bandingkan dengan gambar dan validasi langkah aplikasi berikutnya |
Saat mengadaptasi perintah ke job queue, jauhkan secret dari payload job yang diserialisasi dan bacalah melalui konfigurasi saat eksekusi. Definisikan perilaku retry job secara eksplisit. Kembalikan hasil yang belum terselesaikan ke alur kerja pemanggil ketika Anda tidak dapat memastikan bahwa sebuah hasil telah diterima.
Untuk troubleshooting operasional yang lebih luas, artikel kami tentang penjelasan error proxy DNS dinamis menjelaskan jenis kegagalan terkait sesi yang berbeda. Contoh tersebut menyangkut konsistensi proxy, bukan pengenalan gambar; jangan terapkan parameter task‑nya pada perintah ini.
Pilih task berdasarkan challenge yang benar‑benar Anda miliki, bukan mengirim setiap CAPTCHA ke endpoint pengenalan gambar. Hasil image‑to‑text adalah string. Itu tidak dapat menggantikan token yang diharapkan oleh integrasi reCAPTCHA atau Turnstile.
Gunakan jenis task API yang didukung untuk mengidentifikasi kontrak yang relevan. Eksekusi browser, parameter widget, dan pengiriman ke tujuan tetap menjadi tanggung jawab terpisah. Selesaikan alur kerja gambar kecil terlebih dahulu, lalu bangun dan uji task spesifik yang didukung sesuai kebutuhan aplikasi Anda.
HTTP client bawaan Laravel sudah cukup untuk integrasi solver yang kecil dan mudah diperiksa. Pertahankan permintaan di sisi server, gunakan skema task yang terdokumentasi, dan validasi baik hasil maupun langkah aplikasi berikutnya. CapSolver kemudian dapat menempati langkah CAPTCHA dalam alur kerja terotorisasi tanpa mengambil alih bagian aplikasi lainnya.
T: Apakah saya membutuhkan paket solver CAPTCHA Laravel?
Tidak. Contoh ini menggunakan HTTP client bawaan Laravel untuk memanggil API secara langsung. Wrapper terpisah bersifat opsional dan harus diperiksa terhadap kontrak task saat ini sebelum digunakan.
T: Apakah ini menambahkan proteksi CAPTCHA ke form login Laravel saya?
Tidak. Perintah ini mengenali image challenge yang terotorisasi melalui solver API. Menambahkan proteksi CAPTCHA ke form Anda sendiri adalah integrasi berbeda dengan layanan validasi milik penyedia CAPTCHA.
T: Apakah saya perlu melakukan polling ke getTaskResult untuk contoh ini?
Tidak. ImageToTextTask mengembalikan hasil pengenalan langsung dari createTask. Jenis task lain mungkin menggunakan alur hasil yang berbeda, jadi ikuti dokumentasi untuk task yang dipilih.
T: Bisakah kode ini menyelesaikan reCAPTCHA atau Turnstile apa adanya?
Tidak. Kode ini mengirim ImageToTextTask dan mengharapkan teks. reCAPTCHA dan Turnstile menggunakan parameter task dan hasil token yang berbeda; mengubah nama task saja tidaklah cukup.
T: Haruskah saya melakukan retry otomatis setelah timeout?
Jangan begitu saja membuat task yang sama lagi. Timeout dapat terjadi setelah permintaan mencapai layanan, jadi periksa kegagalannya dan definisikan kebijakan retry yang terbatas sebelum menambahkan retry otomatis.

Emma Foster
Machine Learning Engineer
Where machine learning meets practical AI tooling.
TENTANG PENULIS
Bandingkan alur kerja CAPTCHA tanpa antarmuka (headless) dan dengan antarmuka (headed) menggunakan uji gambar terkontrol, hasil API nyata, dan pemeriksaan penerimaan formulir. Pelajari apa yang dibuktikan oleh hasil tersebut.

Tambahkan pemecah CAPTCHA ke Cypress dengan tugas Node, simpan kunci API di luar kode browser, dan verifikasi formulir image-CAPTCHA milik sendiri dengan contoh JavaScript yang telah diuji.
