phil/address-bundle

alpha

Un formulaire d'adresse pour Symfony dont les champs suivent le pays choisi.

phil/address-bundle apporte les adresses de phil/address dans Symfony. AddressType affiche les champs du format du pays choisi, dans son ordre, nommés comme il les nomme et exigés comme il les exige. Lorsque le pays a des États ou des provinces, la région administrative est un choix parmi eux. Quand le pays change, un contrôleur Stimulus lit le point de terminaison des formats du bundle, puis affiche, masque et renomme les champs dans le navigateur. À la soumission, l'adresse est vérifiée par rapport à son pays, et chaque champ erroné reçoit sa propre erreur. Le bundle fournit aussi la contrainte ValidAddress, le type de colonne Doctrine phil_address pour une seule colonne JSON, les filtres Twig address, address_lines et address_label, et les fonctions Twig country_name et address_schema. Les libellés et les messages sont en anglais et en français.

Il s'adresse aux applications Symfony où un client, un membre ou un rédacteur saisit une adresse qui peut se trouver dans n'importe quel pays, et où des pages ou des étiquettes postales la réaffichent. Des options limitent les pays offerts et ajoutent les noms du destinataire.

Hors de Symfony, utilisez phil/address seul. Le bundle laisse les règles dans la bibliothèque. Le formulaire et la contrainte interrogent son validateur, le point de terminaison lit ses formats, le type de colonne utilise AddressArray, et Twig son outil de mise en forme.

État

Partie	État
`AddressType` : champs du pays, États sous forme de choix, erreurs par champ	Implémenté et testé
Le point de terminaison des formats et le contrôleur Stimulus `address`	Implémenté et testé
`ValidAddress`, le type de colonne `phil_address`	Implémenté et testé
Twig : `address`, `address_lines`, `address_label`, `country_name`, `address_schema`	Implémenté et testé

Documentation

Document	Contenu
Installation	Prérequis, enregistrement, configuration, la route.
Formulaires	`AddressType`, ses options et son contrôleur Stimulus.
Validation et stockage	`ValidAddress` et `phil_address`.
Twig	Les filtres et les fonctions.
Points d'extension	Ce qu'une application implémente, configure, remplace ou utilise.
Tests	Comment le bundle est testé.
Référence	Chaque type du bundle.

Démarrage rapide

composer require phil/address-bundle

phil_address:
    default_country: CA
    format_url: /address-format/__COUNTRY__

$builder->add('address', AddressType::class);

{{ shop.address|address|nl2br }}

Prérequis

PHP 8.5 ou plus récent avec ext-intl ; phil/address 0.1 ; les composants config, dependency injection, form, HTTP foundation, Intl, options resolver et validator de Symfony 8.2, et les contrats de traduction. Doctrine DBAL, le routeur et Twig sont facultatifs.

Contribuer

Les contributions sont les bienvenues sur le monodépôt PHIL : lisez le guide de contribution et le code de conduite. Signalez une vulnérabilité en privé, comme l'explique la politique de sécurité, jamais dans un ticket public.

État

Documentation

Démarrage rapide

Prérequis

Contribuer

Licence