پرش به محتوای اصلی
آرون‌سافت
درخواست مشاوره
ابزارهای امنیتی

Aron Captcha؛ کپچای ایمن، سریع و فارسی برای پروژه‌های لاراول

راهنمای جامع نصب، سفارشی‌سازی و استفاده از اعتبارسنجی ضد ربات در لاراول.

شروع راهنما (گام به گام) مشاهده در GitHub

مزایای کلیدی

  • امنیت هوشمند

    پشتیبانی از چالش‌های ریاضی و متنی برای حفاظت مؤثر.

  • شخصی‌سازی کامل

    کنترل بر ظاهر کپچا (رنگ‌ها، فونت Vazirmatn، نویز و ...).

  • Ajax Refresh

    تغییر کد کپچا بدون رفرش کامل صفحه.

  • ادغام لاراول

    استفاده‌ی آسان از CaptchaRule در سیستم اعتبارسنجی لاراول.

راهنمای نصب و راه‌اندازی (گام به گام)

  1. ۱

    نصب پکیج

    پکیج را از طریق Composer اضافه کنید. پکیج به صورت خودکار کشف می‌شود (Autodiscovery).

    composer require aronlabs/captcha
  2. ۲

    انتشار فایل تنظیمات

    فایل تنظیمات را منتشر کنید تا بتوانید نوع چالش (text یا math)، طول کد و تنظیمات GD را تغییر دهید. فایل در config/aron-captcha.php قرار می‌گیرد.

    php artisan vendor:publish --tag=aronlabs-captcha-config
  3. ۳

    نمایش کپچا در فرم (Blade)

    کد زیر شامل تصویر کپچا و فیلد ورودی پنهان (Session Key) است. آن را در هر فرمی که نیاز به اعتبارسنجی دارد قرار دهید:

    @include('aronlabs-captcha::captcha-input')
  4. ۴

    اعتبارسنجی سمت سرور

    در Controller یا Form Request از کلاس CaptchaRule استفاده کنید. نام فیلد باید با نام input در ویو مطابقت داشته باشد (پیش‌فرض: captcha).

    use AronLabs\Captcha\Rules\CaptchaRule;

$request->validate([
    'captcha' => ['required', new CaptchaRule],
]);
  5. ۵

    سفارشی‌سازی View و فونت (اختیاری)

    برای تغییر ظاهر Blade و استفاده از فونت دلخواه، دستورات زیر را اجرا کنید. فایل‌ها در resources/views/vendor/aronlabs-captcha و public/vendor/aronlabs-captcha/fonts قرار می‌گیرند.

    php artisan vendor:publish --tag=aronlabs-captcha-views
php artisan vendor:publish --tag=aronlabs-captcha-fonts
  6. ۶

    فعال‌سازی Ajax Refresh

    برای عملکرد دکمه‌ی رفرش Ajax، مطمئن شوید @stack('scripts') در انتهای Layout اصلی (قبل از بسته شدن body) وجود دارد.

    @stack('scripts')

آماده تقویت امنیت هستید؟

سؤالات خود را بپرسید یا نیازهای سفارشی‌سازی را با ما در میان بگذارید.

مشاهده مستندات کامل تماس با پشتیبانی