nicocau / signing-bundle
Capture de signatures manuscrites pour Symfony : un simple SignatureType, rendu et sécurisé automatiquement (Stimulus + signature_pad).
Maintainers
Package info
gitlab.com/bundle-symfony/signingbundle
Type:symfony-bundle
pkg:composer/nicocau/signing-bundle
Requires
- php: >=8.2
- symfony/form: ^7.4|^8.0
- symfony/framework-bundle: ^7.4|^8.0
- symfony/stimulus-bundle: ^2.9|^3.0
- symfony/validator: ^7.4|^8.0
- twig/twig: ^3.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.95
- phpstan/phpstan: ^2.2
- symfony/phpunit-bridge: ^7.4|^8.0
README
Capture de signatures manuscrites (souris / doigt) pour Symfony 7.4+ /
PHP 8.2+. Le développeur n'utilise qu'un simple champ de formulaire
SignatureType ; le bundle gère l'interface, la capture, le rognage
automatique, la conversion en data URI base64 et la validation sécurisée côté
serveur.
Basé sur signature_pad + Stimulus.
use NicoCau\SigningBundle\Form\SignatureType;
$builder->add('signature', SignatureType::class);
{{ form_row(form.signature) }}
Points forts
- ✍️
SignatureType: un champ, capture souris et tactile, zéro JS à écrire - ✂️ Rognage automatique de la signature (idéal pour insertion dans un PDF)
- 🖼️ Sortie PNG ou SVG, fond exporté toujours transparent
- 🔒 Validation serveur robuste automatique : format, taille (anti-DoS), dimensions, canvas vide, SVG assaini (anti-XSS)
- ⚡ Stimulus + AssetMapper (stack Symfony par défaut), contrôleur lazy
Installation express
composer require nicocau/signing-bundle
php bin/console importmap:require signature_pad
Le bundle, le contrôleur Stimulus et le thème de formulaire sont enregistrés automatiquement (Flex).
📖 Documentation complète
La documentation détaillée vit dans le dossier docs/ et est
publiée en HTML sur GitLab Pages à chaque version.
| Page | Sujet |
|---|---|
| Installation | Composer, bundle, importmap, vérifications |
| Utilisation | SignatureType, options, récupération, affichage |
| Sécurité & validation | Contrainte Signature, garanties, usage manuel |
| Recettes & avancé | Rognage, événements Stimulus, héritage, Turbo |
Licence
MIT (voir LICENSE). signature_pad est distribué sous licence MIT.