Download the PHP package forutan/fcaptcha without Composer

On this page you can find all versions of the php package forutan/fcaptcha. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package fcaptcha

📦 Install via Packagist
🐙 View source on GitHub

🛡️ FCaptcha — Laravel Image-Based CAPTCHA

A secure, modular, image-based CAPTCHA for Laravel with cryptographic protection and multi-context support (login, checkout, etc.). Effectively prevents automated spam in production forms.

Table of Contents 📚


Features



Requirements

To use the fcaptcha:prepare-images command, ImageMagick must be installed and available in your system's PATH:

You can verify the installation using:


Installation

Install via Composer:

Publish the config file (this will copy the default settings to config/fcaptcha.php):


Prepare CAPTCHA Images

FCaptcha requires categorized images to generate visual CAPTCHAs. You can prepare your image set using one of these four methods (in order of priority):

📁 Required Folder Structure (All Methods)

No matter which method you choose — whether a custom path, config value, built-in demo set, or published assets — the images folder must follow this categorized layout:

➊ Method 1: Custom folder path (CLI flag)

Pass the images folder path directly via --from:

➋ Method 2: Path via Config

Set your path in config/fcaptcha.php like this:

Then run:

➌ Method 3: Use Built-in Demo Images

If you don't specify --from and leave image_seed_path as null (in config/fcaptcha.php ), FCaptcha will automatically use the built-in demo images from:

In this case, just run:

➍ Method 4: Customize Built-in Images

To use and modify the internal demo set:

⚠️ Important: After modifying your image set or resetting the database, you must re-run the image preparation command to sync the new data.


🎉 FCaptcha is now ready to power your Laravel forms with strong, customizable CAPTCHA protection.
Enjoy secure, bot-resistant interactions — right out of the box 💻🛡️

Middleware Usage

Apply fcaptcha.verified:{context} middleware to any route.

Example: single route

Example: group of routes

Each context is verified separately.


Configuration

FCaptcha comes with customizable UI and behavior. You can tweak both via Blade views and config values.

🖌️ Customize the CAPTCHA UI

Publish the default Blade view:

Edit the files under:

You can modify layout, texts, styles, or add your own branding.

🛠️ Change Behavior & Limits

Configuration file is located at config/fcaptcha.php. It controls core behavior of FCaptcha — including image sizes, retry limits, category logic, and redirect behavior.

Key options:


Probability of Random Success

The probability of randomly solving the CAPTCHA (by pure guessing) is shown below:

🎯 Formula:
P = 1 / C(n, k)
where n = total images and k = required correct selections

Correct Images (k) Combinations (C(12, k)) Probability
3 220 ~0.45%
4 495 ~0.20%
5 792 ~0.13%
6 924 ~0.11%

Average success chance: < 0.4% — providing strong protection against bots.


Contributing

Have ideas for improvements? Found a bug?
Pull requests and issues are warmly welcome — let's make FCaptcha even better together!


Support

If you find FCaptcha helpful:

👉 Donate here


Commercial License

This project is licensed under a custom non-commercial license. Usage is permitted only for personal and academic purposes. Commercial use of any kind is strictly prohibited. For commercial inquiries, please contact:

👉 Request license


All versions of fcaptcha with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
illuminate/support Version ^9.0|^10.0|^11.0|^12.0
illuminate/routing Version ^9.0|^10.0|^11.0|^12.0
illuminate/http Version ^9.0|^10.0|^11.0|^12.0
illuminate/database Version ^9.0|^10.0|^11.0|^12.0
illuminate/console Version ^9.0|^10.0|^11.0|^12.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package forutan/fcaptcha contains the following files

Loading the files please wait ...