valksor/php-form-type

Symfony Form types for spam and bot protection

dev-master / 1.0.x-dev 2026-01-24 23:21 UTC

Requires

• php: >=8.4
• composer-runtime-api: ^2
• symfony/config: *
• symfony/dependency-injection: *
• symfony/form: *
• symfony/http-foundation: *
• symfony/options-resolver: *

Requires (Dev)

• phpunit/phpunit: ^12.0

Replaces

• valksor/php-form-type-cloudflare-turnstile: dev-master
• valksor/php-form-type-honey-pot: dev-master

BSD-3-Clause

• symfony
• php
• form
• spam
• protection
• valksor

README

This repository contains these:

Repository	Coverage	Repository	Coverage
php-form-type-honey-pot		php-form-type-cloudflare-turnstile

A collection of Symfony Form Types and Extensions providing spam protection through honeypot fields and Cloudflare Turnstile CAPTCHA integration. This is a meta-package that includes all the Valksor form type sub-libraries.

Installation

Install the package via Composer:

composer require valksor/php-form-type

This will install all the form type sub-libraries at once.

Requirements

• PHP 8.4 or higher
• Symfony Form Component (>=6.4)
• Symfony HttpFoundation
• Symfony HttpClient (for Turnstile validation)
• Symfony Validator

Included Sub-libraries

This meta-package includes the following form type libraries:

• valksor/php-form-type-honey-pot - Form extension adding honeypot trap for bot detection
• valksor/php-form-type-cloudflare-turnstile - Form type for Cloudflare Turnstile with server-side validation

Each sub-library can also be installed individually if you only need specific functionality.

Usage

Each sub-library has its own usage instructions. Please refer to the README.md file in each sub-library's directory for specific usage examples.

Generally, components are auto-discovered when using the Valksor bundle:

1. Add to config/bundles.php:

Valksor\Bundle\ValksorBundle::class => ['all' => true],

1. Configure via config/packages/valksor.yaml if needed.

Contributing

Contributions are welcome!

• Code style requirements (PSR-12)
• Testing requirements for PRs
• One feature per pull request
• Development setup instructions

To contribute to form type libraries:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-form-type)
3. Implement your form type following existing patterns
4. Add comprehensive tests
5. Ensure all tests pass and code style is correct
6. Submit a pull request

Creating New Form Type Libraries

When adding new form type libraries:

1. Create namespace under Valksor\Component\FormType\{Name}
2. Implement Form Type or Extension class
3. Add comprehensive test coverage in Tests/
4. Create composer.json with proper dependencies
5. Update meta-package composer.json to include new library
6. Update documentation with examples

Security

If you discover any security-related issues, please email us at [e-mail] instead of using the issue tracker.

Support

• Documentation: Full documentation
• Issues: GitHub Issues for bug reports and feature requests
• Discussions: GitHub Discussions for questions and community support

Credits

• Original Author - Creator and maintainer
• All Contributors - Thank you to all who contributed
• Symfony Form - Form component foundation
• Cloudflare Turnstile - CAPTCHA service integration
• Valksor Project - Part of the larger Valksor PHP ecosystem

License

This package is licensed under the BSD-3-Clause License.

About Valksor

This package is part of the valksor/php-valksor project - a comprehensive PHP library and Symfony bundle that provides a collection of utilities, components, and integrations for Symfony applications.

The main project includes:

• Various utility functions and components
• Doctrine ORM tools and extensions
• Symfony bundle for easy configuration
• And much more

If you find these form type components useful, you might want to check out the full Valksor project for additional tools and utilities that can enhance your Symfony application development.

To install the complete package:

composer require valksor/php-valksor