Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sbsedv/form-bundle
A Symfony bundle that adds some usefull symfony/form integrations.
https://github.com/sbsedv/form-bundle
php php8 php82 symfony symfony-bundle symfony-form symfony6
Last synced: 5 days ago
JSON representation
A Symfony bundle that adds some usefull symfony/form integrations.
- Host: GitHub
- URL: https://github.com/sbsedv/form-bundle
- Owner: SBSEDV
- License: mit
- Created: 2022-05-21T13:08:51.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-01T15:59:35.000Z (10 months ago)
- Last Synced: 2024-09-25T20:08:27.719Z (8 days ago)
- Topics: php, php8, php82, symfony, symfony-bundle, symfony-form, symfony6
- Language: PHP
- Homepage:
- Size: 86.9 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/SBSEDV/form-bundle/actions/workflows/phpstan.yml)
[](https://github.com/SBSEDV/form-bundle/actions/workflows/phpcsfixer.yml)
# sbsedv/form-bundle
A [Symfony](https://symfony.com/) bundle that adds some usefull [symfony/form](https://github.com/symfony/form) integrations.
---
## **Error Normalizer**
This bundle registers two [symfony/serializer](https://github.com/symfony/serializer) normalizers for form errors.
#### [**FormErrorNormalizer**](./src/Serializer/Normalizer/FormErrorNormalizer.php)
The most important normalizer. This normalizer supports submitted, invalid form.
The normalized data is an associative array with the following structure:
```json
[
{
// Each FormError object has its own entry
"message": "The FormError object message",
"type": "invalid_request_error",
"param": "first_name", // OPTIONAL
"cause": "is_blank_error" // OPTIONAL
}
]
```
The `param` key will contain, by default, the property path of the child form that the FormError originates from. This key will not exist if the error originates from the root form (e.g. invalid CSRF Token).
The "cause" key is intended to contain an error name based on the FormError cause.
You can customize the keys behaviour by registering a service that implements [ParamResolverInterface](./src/ParamResolver/ParamResolverInterface.php) or [CauseResolverInterface](./src/CauseResolver/CauseResolverInterface.php).
If autoconfiguration is disabled, you have to tag the service with `sbsedv_form.param_resolver` or `sbsedv_form.cause_resolver`.
The normalizer uses tagged iterators, so you can set a "priority" attribute with the tag.
You can also customize the key names and type value with the normalizer context.
See [FormErrorNormalizer](./src/Serializer/Normalizer/FormErrorNormalizer.php).
#### [**UnsubmittedFormNormalizer**](./src/Serializer/Normalizer/UnsubmittedFormNormalizer.php)
This normalizer supports unsubmitted.
The normalized data is an associative array with the following structure:
```json
[
{
"message": "The request body does not contain any usable data.",
"type": "invalid_request_error"
}
]
```
The error message is customizable via "request_body_is_empty" in the "sbsedv_form" translation domain.
You can also customize the key names and type value with the normalizer context.
See [UnsubmittedFormNormalizer](./src/Serializer/Normalizer/UnsubmittedFormNormalizer.php).
---
## **Form Types**
This bundle registers the following form types:
- [BooleanType](./src/Form/Type/BooleanType.php)
Converts boolean values to boolean type
- [UuidTypeExtension](./src/Form/Extension/UuidTypeExtension.php)
Extends the default UuidType with optional "as_string" and "nil_to_null" (NilUuid to null) options.
---
## **Data Transformers**
This bundle provides the following data transformers:
- [CapitalizeStringDataTransformer](./src/Form/DataTransformer/CapitalizeStringDataTransformer.php) (ucfirst)
- [LowercaseStringDataTransformer](./src/Form/DataTransformer/LowercaseStringDataTransformer.php) (strtolower)
- [UppercaseStringDataTransformer](./src/Form/DataTransformer/UppercaseStringDataTransformer.php) (strtoupper)