
Anh Tuan
Data Science Expert
Đã xuất bản Nov 19, 2026
Đã cập nhật Nov 19, 2026 · đọc tối thiểu

ImageToTextTask; tác vụ đó trả về kết quả nhận dạng trực tiếp từ createTask.errorId của API, sau đó xác thực solution.text trước khi sử dụng.Trình giải CAPTCHA cung cấp cho ứng dụng Laravel một bước xử lý phía server cho một thử thách được hỗ trợ trong một luồng công việc đã được ủy quyền. Laravel là một framework ứng dụng web PHP: nó có thể chạy mã ứng dụng, lệnh console và công việc chạy nền. HTTP client của nó gửi yêu cầu API; nó không render trang trình duyệt hay vận hành widget CAPTCHA.
Ví dụ, một công cụ vận hành nội bộ có thể nhận được thử thách hình ảnh trong quá trình truy xuất tài liệu đã được phê duyệt. Ứng dụng gửi hình ảnh tới trình giải, kiểm tra văn bản trả về và chuyển đáp án đó cho bước tương ứng trong luồng công việc hiện có. Ứng dụng vẫn tự quản lý phiên, xác thực kết quả và quyết định tiếp tục hay không.
Hướng dẫn này sử dụng CapSolver với HTTP client gốc của Laravel. Ví dụ dừng lại ở việc nhận dạng một ảnh kiểm thử cục bộ thuộc sở hữu của bạn, giúp việc xem xét request và kết quả trở nên dễ dàng trước khi kết nối chúng với ứng dụng lớn hơn. Đây không phải là hướng dẫn cài CAPTCHA bảo vệ cho form của chính bạn.
Bắt đầu với một ứng dụng Laravel đang hoạt động, một tài khoản CapSolver có số dư khả dụng, và một ảnh PNG hoặc JPEG cục bộ mà bạn sở hữu hoặc được phép xử lý. Đặt ảnh tại storage/app/fixture.png để dùng cho lệnh bên dưới. Chọn một ảnh văn bản đơn giản với đáp án dự kiến mà bạn có thể tự kiểm tra.
Chạy các lệnh từ thư mục gốc dự án Laravel. Việc tích hợp sử dụng HTTP client của framework, vì vậy không cần SDK trình giải riêng. PHP phải có khả năng thiết lập kết nối HTTPS đã được xác minh tới API.
Tác vụ được dùng ở đây là ImageToTextTask. Trường body của nó chứa dữ liệu Base64 của ảnh, không kèm tiền tố data-URI. Module common trả về văn bản đã nhận dạng. Khác với luồng tác vụ bất đồng bộ, tác vụ nhận dạng này trả về kết quả trong phản hồi createTask; ví dụ này không gọi getTaskResult.
Lưu khóa API trong môi trường của ứng dụng và để lộ nó thông qua một file cấu hình. Thêm mục này vào .env trên server, thay thế giá trị mẫu bằng khóa thực tế:
CAPSOLVER_API_KEY=YOUR_CAPSOLVER_API_KEY
Tạo config/capsolver.php:
<?php
return ['api_key' => env('CAPSOLVER_API_KEY')];
Lệnh sẽ đọc config('capsolver.api_key'). Tài liệu cấu hình của Laravel giải thích tại sao giá trị môi trường nên đặt trong file cấu hình, đặc biệt khi cấu hình được cache. Nếu triển khai của bạn dùng cache cấu hình, hãy rebuild nó thông qua quy trình triển khai thông thường sau khi thay đổi khóa.
Giữ .env ngoài hệ thống quản lý phiên bản và không truyền khóa cho JavaScript phía frontend. Tránh ghi log nội dung body request gửi đi: trường clientKey là thông tin định danh nhạy cảm, và trường ảnh có thể chứa dữ liệu bạn không muốn xuất hiện trong log ứng dụng chung.
Thêm lệnh closure sau vào routes/console.php, giữ nguyên các lệnh khác nếu đã tồn tại. Laravel hỗ trợ lệnh Artisan dựa trên closure; điều này giúp lần tích hợp đầu tiên đủ nhỏ để chạy và kiểm tra trực tiếp.
Lệnh sẽ kiểm tra hợp lệ đầu vào cục bộ, gửi một request và chỉ in ra kết quả văn bản không rỗng sau khi các bước kiểm tra phản hồi vượt qua. Giới hạn PNG/JPEG và giá trị timeout là các lựa chọn ví dụ ở cấp ứng dụng, không phải danh sách đầy đủ các giới hạn của nhà cung cấp.
<?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');
Việc kiểm tra HTTP status là quan trọng vì Laravel không tự động ném ngoại lệ cho mọi phản hồi lỗi HTTP. Kiểm tra ở mức API là bước riêng: một phản hồi HTTP thành công vẫn phải chứa errorId mong đợi, trạng thái tác vụ và trường kết quả.
Lệnh này cố ý không tự động retry tạo tác vụ. Timeout kết nối có thể khiến bạn không chắc liệu dịch vụ đã nhận request ban đầu hay chưa. Hãy kiểm tra nguyên nhân lỗi trước khi gửi lại, đặc biệt khi chuyển thao tác này vào queue với chính sách retry riêng.
Nhận mã thưởng CapSolver
Tăng ngân sách tự động hóa ngay lập tức!
Dùng mã thưởng CAP26 khi nạp tiền vào tài khoản CapSolver để nhận thêm 5% tiền thưởng cho mọi lần nạp — không giới hạn.
Nhập mã ngay trong Bảng điều khiển CapSolver
Chạy lệnh một lần với ảnh kiểm thử cục bộ:
php artisan captcha:read storage/app/fixture.png
Với một ảnh chứa 583729, kết quả mong đợi là:
583729
So sánh văn bản trả về với ảnh thực tế, bao gồm cả phân biệt hoa/thường và các ký tự dễ nhầm lẫn. Một chuỗi không rỗng chứng minh rằng request đã tạo ra kết quả; nó không đảm bảo độ chính xác cho mọi ảnh trong tương lai. Hãy dùng phản hồi chấp nhận của hệ thống đích làm một bước kiểm tra riêng khi bạn kết nối bước này vào một luồng công việc ứng dụng được phép.
Nếu PHP báo lỗi về file chứng chỉ hoặc kho tin cậy, hãy sửa cấu hình CA bundle cho runtime đó trước khi thử lại. Giữ việc kiểm tra chứng chỉ TLS luôn bật. Thông điệp lỗi kết nối của lệnh được cố ý giữ ngắn gọn; hãy điều tra chi tiết hạ tầng ở nơi khác mà không hiển thị thông tin định danh hay body request.
Giữ riêng các loại kết quả: lỗi đầu vào, lỗi truyền tải, lỗi API và việc đích đến từ chối kết quả. Sự phân biệt này tránh việc một file bị thiếu lại trở thành một lần retry API mất phí, và tránh việc lỗi validation ứng dụng bị tính như lỗi ngừng hoạt động của trình giải.
| Kết quả | Hành động tiếp theo |
|---|---|
| Thiếu khóa API | Sửa cấu hình server trước khi gửi request |
| Thiếu file hoặc không được ví dụ này hỗ trợ | Sửa đầu vào; không cần gửi request cho trình giải |
| Kết nối lỗi hoặc timeout | Kiểm tra cấu hình mạng và TLS; xem xét trước khi gửi lại |
| Lỗi HTTP hoặc API | Ghi nhận status hoặc mã lỗi và làm theo hướng dẫn API tương ứng |
| Trả về văn bản | So sánh với ảnh và xác thực bước ứng dụng tiếp theo |
Khi chuyển lệnh này thành job queue, giữ bí mật (secret) ngoài payload job được serialize và đọc chúng qua cấu hình tại thời điểm thực thi. Định nghĩa rõ ràng hành vi retry của job. Trả về trạng thái “chưa giải quyết” cho luồng gọi khi bạn không thể xác nhận rằng kết quả đã được chấp nhận.
Để hỗ trợ xử lý sự cố vận hành rộng hơn, bài viết giải thích lỗi proxy DNS động của chúng tôi mô tả một lỗi khác liên quan đến session. Ví dụ đó liên quan đến tính nhất quán proxy, không phải nhận dạng ảnh; đừng áp dụng tham số tác vụ của nó cho lệnh này.
Chọn tác vụ dựa trên thử thách bạn thực sự gặp, thay vì gửi mọi CAPTCHA tới endpoint nhận dạng ảnh. Kết quả image-to-text là một chuỗi. Nó không thể thay thế token mà tích hợp reCAPTCHA hoặc Turnstile yêu cầu.
Hãy sử dụng các loại tác vụ API được hỗ trợ để xác định hợp đồng phù hợp. Thực thi trình duyệt, tham số widget và việc gửi dữ liệu đến đích vẫn là các trách nhiệm riêng. Hoàn tất luồng công việc ảnh nhỏ này trước, sau đó xây dựng và kiểm thử loại tác vụ được hỗ trợ cụ thể mà ứng dụng của bạn cần.
HTTP client gốc của Laravel là đủ cho một tích hợp trình giải nhỏ, dễ kiểm tra. Giữ request ở phía server, dùng schema tác vụ được tài liệu hóa, và xác thực cả kết quả lẫn bước ứng dụng tiếp theo. CapSolver khi đó có thể đảm nhiệm bước CAPTCHA trong một luồng công việc được ủy quyền mà không chiếm quyền kiểm soát phần còn lại của ứng dụng.
H: Tôi có cần package trình giải CAPTCHA cho Laravel không?
Không. Ví dụ này dùng HTTP client tích hợp sẵn của Laravel để gọi API trực tiếp. Wrapper riêng là tùy chọn và nên được kiểm tra với hợp đồng tác vụ hiện tại trước khi dùng.
H: Cái này có thêm CAPTCHA bảo vệ cho form đăng nhập Laravel của tôi không?
Không. Lệnh này nhận dạng một thử thách ảnh đã được ủy quyền thông qua solver API. Thêm CAPTCHA bảo vệ cho form của chính bạn là một kiểu tích hợp khác với dịch vụ xác thực của nhà cung cấp CAPTCHA.
H: Tôi có cần poll getTaskResult cho ví dụ này không?
Không. ImageToTextTask trả về kết quả nhận dạng trực tiếp từ createTask. Các loại tác vụ khác có thể dùng luồng kết quả khác, vì vậy hãy làm theo tài liệu cho loại tác vụ bạn chọn.
H: Đoạn code này có thể giải reCAPTCHA hoặc Turnstile như hiện tại không?
Không. Đoạn code này gửi một ImageToTextTask và mong đợi văn bản. reCAPTCHA và Turnstile dùng tham số tác vụ và kết quả dạng token khác; chỉ đổi tên tác vụ là không đủ.
H: Tôi có nên tự động retry sau khi timeout không?
Đừng tạo lại cùng một tác vụ một cách mù quáng. Timeout có thể xảy ra sau khi request đã đến dịch vụ, nên hãy kiểm tra nguyên nhân lỗi và định nghĩa một chính sách retry có giới hạn trước khi thêm retry tự động.

Anh Tuan
Data Science Expert
Turning task outcomes into actionable insights.
GIỚI THIỆU TÁC GIẢ
So sánh quy trình CAPTCHA không giao diện và có giao diện bằng một bài kiểm tra hình ảnh có kiểm soát, kết quả API thực tế và các bước kiểm tra chấp nhận biểu mẫu. Tìm hiểu những gì các kết quả chứng minh.

Thêm một trình giải CAPTCHA vào Cypress bằng một tác vụ Node, giữ khóa API bên ngoài mã trình duyệt, và xác minh một biểu mẫu hình ảnh CAPTCHA thuộc sở hữu của bạn bằng một ví dụ JavaScript đã được kiểm thử.
