راهنمای کامل نصب و راهاندازی (گام به گام)
گام ۱: نصب پکیج
پکیج را از طریق Composer به پروژه لاراول خود اضافه کنید. پکیج به صورت خودکار کشف میشود (Autodiscovery):
گام ۲: انتشار فایلهای اصلی (Config)
فایل تنظیمات را منتشر کنید تا بتوانید نوع چالش (`text` یا `math`)، طول کد، و تنظیمات GD را تغییر دهید. فایل در `config/aron-captcha.php` قرار میگیرد:
گام ۳: نمایش کپچا در فرم (Blade)
کد زیر شامل تصویر کپچا و فیلد ورودی پنهان (Session Key) است. آن را در هر فرمی که نیاز به اعتبارسنجی دارد (مثلاً ورود/ثبتنام) قرار دهید:
گام ۴: اعتبارسنجی سمت سرور
در Controller یا Form Request خود، از کلاس `CaptchaRule` استفاده کنید. توجه کنید که نام فیلد باید با نام `input` در ویو مطابقت داشته باشد (به صورت پیشفرض `captcha` است):
use AronLabs\Captcha\Rules\CaptchaRule;
// ...
$request->validate([
// ...
'captcha' => ['required', new CaptchaRule],
]);
گام ۵: سفارشیسازی View و Font (اختیاری)
برای تغییر ظاهر Blade و استفاده از فونتهای دلخواه، دستورات زیر را اجرا کنید:
php artisan vendor:publish --tag=aronlabs-captcha-fonts
فایلهای منتشر شده در مسیرهای `resources/views/vendor/aronlabs-captcha` و `public/vendor/aronlabs-captcha/fonts` قرار میگیرند.
گام ۶: فعالسازی Ajax Refresh
برای اطمینان از عملکرد دکمه رفرش Ajax، مطمئن شوید که تگ `@stack('scripts')` در انتهای فایل اصلی Layout شما (قبل از بسته شدن تگ `</body>`) وجود دارد: