Persistance des objets de valeur de types de données PHP avec Doctrine DBAL - Configuration automatique Laravel, aucune configuration requise

Doctrine des types de données PHP de Laravel

Ce package permet de déclarer un objet de hradigital/php-datatypes comme type d'un attribut d'entité Doctrine. Doctrine ne conserve que les types fournis par défaut ; autrement, un objet de EmailAddress , Money ou Address devrait être déclaré comme primitif et converti manuellement à chaque lecture et écriture. Il inclut un type DBAL Doctrine par objet Datatypes, ainsi qu'un fournisseur de services Laravel qui les enregistre tous. Ainsi, l'entité contient l'objet valeur tandis que la base de données conserve une valeur simple, indexable et lisible par l'utilisateur.

• Types Doctrine DBAL - un par objet Datatypes : StrType , EmailAddressType , UrlType , SlugType , DatetimeType , CurrencyType , MoneyType , AddressType et le reste.
• Types PHP natifs - NativeDateTimeType , NativeDateTimeImmutableType , NativeDateIntervalType et NativeDateTimeZoneType , donc une entité contenant un simple \DateTime mappe sous la même convention de nommage.
• Fournisseur de services Laravel : détection automatique, enregistrement de chaque type avant qu’un EntityManager ne résolve un mappage. Aucune publication, aucune configuration.
• Une règle de nommage : le nom d’un type Doctrine est toujours le nom court de la classe Type.
• Validation à l'entrée - l'échec de validation d'un objet valeur apparaît comme une erreur DBAL ConversionException , de sorte qu'une valeur invalide est rejetée plutôt que de corrompre la colonne.
• Sans dépendance à un framework : les types sont des types DBAL simples, sans dépendance à un framework ; le fournisseur de services est une commodité.

Ce que ce paquet n'est pas

• Il ne s'agit ni d'une version dérivée ni d'un remplacement de hradigital/php-datatypes Ce module en dépend et ajoute la persistance, rien de plus. Le comportement, la validation et l'API des objets de valeur sont entièrement propres à 0.
• Ce n'est ni un ORM, ni un ensemble d'entités. Il ajoute des types de colonnes. Vos entités, mappings et dépôts restent votre propriété.
• Ce n'est pas réservé à Laravel. Voir Utilisation en dehors de Laravel .

Plateforme complète développée pour une entreprise de construction et de génie civil au Portugal — regroupant leur site web public, leur portefeuille de projets, leurs recrutements, leurs actualités et les témoignages de leurs clients dans une seule application Laravel cohérente.

Conçue autour de contextes délimités couvrant les domaines du monde réel de l'entreprise (informations sur l'entreprise, projets, recrutement, actualités, témoignages, notifications, etc.), suivant une conception axée sur les événements et le domaine et une architecture propre, avec un pipeline dédié basé sur une file d'attente découplant les effets secondaires de la logique du domaine principal.

Entièrement testé sur l'ensemble de la pyramide : unité, intégration, fonctionnel, caractéristique, système et E2E.

Wrapper Laravel pour la bibliothèque PHP-Exception, assurant la gestion des erreurs de Laravel et fournissant un rendu pour ces exceptions.

Exceptions PHP avec Laravel

Câblage Laravel et rendus JSON/Web pour l'arbre d'exceptions de domaine hradigital/php-exceptions .

La bibliothèque de base fournit des exceptions indépendantes de la plateforme ( AbstractBaseException et les arbres Client/ et Server/ , alignés sur la sémantique HTTP 4xx/5xx) et ne connaît rien du transport, laissant à chaque application le soin de décider comment une exception de domaine levée devient une réponse.

Ce package tranche une seule fois. Les requêtes API reçoivent un corps JSON uniforme ; les requêtes web renvoyant une erreur 422 redirigent vers le formulaire d'origine avec les erreurs et les anciennes données saisies ; toute autre exception de package est traitée sur le web avec le statut HTTP qu'elle déclare. Une exception dont le code d'état est différent de AbstractBaseException est transmise au gestionnaire de Laravel sans être modifiée.

• ExceptionRenderer - le répartiteur de stratégie JSON, résolvant une exception à la première stratégie qui la prend en charge, avec un repli toujours correspondant.
• WebRenderer - le répartiteur de stratégie Web, résolvant une exception à la première stratégie qui la prend en charge, avec un repli toujours correspondant.
• ExceptionsServiceProvider - découverte automatique, liaison des deux répartiteurs en tant que singletons et enregistrement de deux renderable() hooks sur le gestionnaire d'exceptions de Laravel.
• Détection d'API - une règle commune aux deux hooks : l'en-tête Accept , un corps JSON, un chemin api/* ou un nom de route api.* .
• Stratégies groupées - DefaultRenderer et InputFailureRenderer pour JSON, InputFailureWebRenderer , UnprocessableEntityWebRenderer et DefaultWebRenderer pour le Web.
• Stratégies personnalisées : résolvez l’instance unique et ajoutez la vôtre ; la dernière inscription l’emporte.

Exceptions de domaine sémantiques et alignées sur HTTP pour les applications PHP 8.1+ DDD — indépendantes du framework, sans dépendances d'exécution

Gestionnaire de formulaires côté client prenant en compte l'état des champs pour les formulaires HTML statiques. Suit l'état de chaque champ (nouveau, inchangé, modifié, invalide, vide) et active/désactive les actions de la barre d'outils en conséquence.

@hradigital/smartforms

Gestionnaire de formulaires côté client prenant en compte l'état pour les formulaires HTML statiques. Il superpose un comportement réactif au HTML généré par une application rendue côté serveur, entièrement piloté par des attributs : associez la classe smartform à un <form> et le gestionnaire prend le relais. Les champs, les boutons de la barre d'outils et les actions HTTP s'adaptent alors à l'état du formulaire, sans React ni Vue, et sans réécriture du balisage déjà envoyé par le serveur.

• État par champ - pistes new , unchanged , changed , invalid et empty , application d'une classe CSS correspondante pour le style.
• Deux mises en page - une liste d'enregistrements ( smartformlist ) ou un seul enregistrement ( smartformrecord ).
• Câblage de la barre d'outils : active et désactive les boutons créer, mettre à jour, supprimer et annuler à partir de l'état global du formulaire.
• Tâches HTTP - associe une action de barre d'outils à un verbe et à un point de terminaison, déclarés dans le balisage.
• formStateChange événements – soit CustomEvent par transition d'état, pour tout ce que la bibliothèque ne couvre pas.
• Pas de framework, pas d'étape de compilation - ESM, CJS et une compilation UMD chargeable directement depuis une balise <script> .

Installation

npm install @hradigital/smartforms
# or
yarn add @hradigital/smartforms
# or
pnpm add @hradigital/smartforms

Ou chargez directement la version UMD dans le navigateur :

<script src="https://unpkg.com/@hradigital/smartforms/dist/smartforms.umd.js"></script>
<script>
    SmartForms.autoInit();
</script>

hradigital.com est mon portfolio d'ingénieur, conçu comme un prolongement de mon CV et de mon profil LinkedIn plutôt que comme une page statique. Il s'agit d'une application Laravel multilingue (EN/PT/FR/ES/DE/NL), architecturée selon les mêmes principes de conception événementielle et de conception pilotée par le domaine (EdDDD) et d'architecture propre que j'applique dans les systèmes fintech en production : une séparation claire entre les couches Application, Domaine, Framework et Infrastructure, conformément aux principes SOLID.

Le site récupère et affiche en temps réel du contenu dynamique, sans l'intégrer directement dans le code, grâce à des intégrations via l'API REST. Il est entièrement testé selon l'ensemble de la pyramide de tests (unitaire, d'intégration, fonctionnel, système et de bout en bout) et reflète la même rigueur d'ingénierie que j'applique à mes projets clients : contextes délimités, événements de domaine et infrastructure qui n'interfère pas avec le domaine.

Action GitHub permettant de calculer la prochaine version publiée à partir des commits conventionnels

Contribuer à la maintenance de la solution Fintech actuelle et aider à la transition de certaines parties du système vers une architecture de microservices.

• Basé sur LAMP (Laravel & Symfony).
• Séparation nette entre les couches Application et Domaine (ainsi qu'entre le Framework et l'Infrastructure).
• Conception pilotée par le domaine et développement piloté par les tests.
• Application des meilleures normes de l'industrie (modèles de conception/principes de conception).

Développement d'un projet de plateforme de négociation pour les transactions sur actifs financiers.

Projet de microservices événementiels, intégré à une solution SaaS Fintech plus vaste, utilisant la gestion de tokens blockchain et de portefeuilles électroniques. Basé sur LAMP (Laravel).

• Développement utilisant une architecture de microservices et événementielle.
• Séparation nette entre les couches Application et Domaine.
• Conception pilotée par le domaine et développement piloté par les tests.
• Application des meilleures normes de l'industrie (modèles de conception/principes de conception).

Éléments constitutifs du DDD pour PHP : un trait testé par attribut, ainsi que des objets de valeur immuables de type Str/int/float, Slug, Url, EmailAddress, Money et datetime. Sans framework ni dépendance tierce.

Types de données PHP

PHP Datatypes construit vos objets de valeur, entités et agrégats à partir de traits prédéfinis et testés (un par attribut), laissant ainsi la définition de classe libre pour la logique métier qui lui appartient.

Les accesseurs renvoient des objets valeur plutôt que des types primitifs chaque fois que cela est possible. Ainsi, chaque valeur bénéficie de sa propre validation et normalisation, évitant à chaque appelant de devoir s'en souvenir. Aucune dépendance tierce n'est requise en dehors de PHP ; ces valeurs fonctionnent donc sans framework, requête HTTP ni moteur de templates.

• AbstractValueObject - la base dont un objet valeur, une entité ou un agrégat étend la construction à partir d'un tableau, une sérialisation complète et toArray() prêt à l'emploi.
• Traits d'entité - un trait par attribut ( HasPositiveIntegerIDTrait , HasActiveTrait , HasNameTrait , ... ), chacun portant les indications de type et la normalisation pour cet attribut.
• Types de données scalaires - wrappers immuables Str , entiers et flottants, avec une API fluide qui renvoie une nouvelle instance à chaque opération plutôt que de modifier la valeur sur place.
• Types de données Web - Slug , Url et EmailAddress , chacun se validant et se normalisant lui-même.
• Types de données datetime - valeurs de date et d'heure, sans avoir recours à une bibliothèque de dates et d'heures.
• Vocabulaire des exceptions - une exception typée par type de données en dessous Exceptions\Datatypes\* , de sorte qu'une valeur rejetée indique ce qu'elle a rejeté et pourquoi.

Portée

Ce paquet contient des types de données : des valeurs qui s’auto-valident et se normalisent, et que toute application PHP peut utiliser sans framework, requête HTTP ni moteur de templates. La règle « Aucune dépendance tierce » est autant une règle de portée qu’une règle de dépendance.

Les comportements liés au rendu, à l'analyse de documents ou à l'affichage d'une page web ne constituent pas un type de données et relèvent du package hradigital/php-markup . php-markup dépend de ce package, et non l'inverse.

Le projet repose sur l'architecture LAMP côté serveur, avec le framework Laravel. Il est divisé en différents packages, utilisés dans plusieurs projets/distributions, dont LRTT. Côté client, nous utilisons HTML5 avec Bootstrap et React.

Ma première mission dans le cadre de ce projet consistait à adapter les fonctionnalités à un plus grand nombre de rôles d'utilisateurs, à adapter le système à l'inscription et à l'authentification des utilisateurs à rôles multiples, à créer un espace dédié pour un nouveau rôle et à développer des fonctionnalités API pour l'interface utilisateur.

Côté interface utilisateur, outre la création d'un nouvel espace dédié à un rôle utilisateur spécifique, il s'agissait de développer une application React qui gérait les informations de Fellowship pour un enseignant bénévole inscrit.

Dans le cadre du développement de ce projet, l'une de mes tâches consistait à migrer le code vers la syntaxe de PHP7 et à documenter le code nouveau et existant à l'aide de PHPDocs.

Restructuration de la mise en page et de la base de données. Refonte et développement des sites web de l'entreprise, basés sur des tableaux, avec de nouvelles fonctionnalités, tout en conservant la même image de marque et en partageant les ressources.

Développement de formulaires Web en .NET 1.1. Conception et développement multimédia en ActionScript et Flash.