PHP-Datentypen-Wertobjekte mit Doctrine DBAL speichern – Laravel-Autowiring, keine Konfiguration erforderlich

php-Datentypen-Laravel-Doktrin

Dieses Paket ermöglicht es, ein Objekt vom hradigital/php-datatypes als deklarierten Typ eines Doctrine-Entity-Attributs festzulegen. Doctrine speichert nur die mitgelieferten Typen. Andernfalls müssten EmailAddress , Money oder Address als primitive Datentypen deklariert und bei jedem Lese- und Schreibvorgang manuell konvertiert werden. Das Paket enthält einen Doctrine-DBAL-Typ pro Datatypes-Objekt sowie einen Laravel-Service-Provider, der alle Typen registriert. Dadurch speichert die Entity das Wertobjekt, während die Datenbank weiterhin einen einfachen, indizierbaren und lesbaren Wert speichert.

• Doctrine DBAL-Typen - einer pro Datatypes-Objekt: StrType , EmailAddressType , UrlType , SlugType , DatetimeType , CurrencyType , MoneyType , AddressType und der Rest.
• Native PHP-Typen - NativeDateTimeType , NativeDateTimeImmutableType , NativeDateIntervalType und NativeDateTimeZoneType , sodass eine Entität, die eine einfache \DateTime -Map enthält, unter der gleichen Namenskonvention fällt.
• Laravel-Service-Provider – wird automatisch erkannt und registriert jeden Typ, bevor ein EntityManager eine Zuordnung auflöst. Nichts zu veröffentlichen, nichts zu konfigurieren.
• Eine Namensregel – der Name eines Doctrine-Typs ist immer der Kurzname der Typklasse selbst.
• Validierung beim Eingang - ein Validierungsfehler eines Wertobjekts wird als DBAL ConversionException angezeigt, sodass ein ungültiger Wert abgelehnt wird, anstatt die Spalte zu beschädigen.
• Framework-optional - die Typen sind einfache DBAL-Typen ohne Framework-Abhängigkeit; der Service Provider ist eine Komfortfunktion.

Was dieses Paket nicht beinhaltet

• Es handelt sich weder um eine Abspaltung noch um einen Ersatz für hradigital/php-datatypes Es baut darauf auf und fügt Persistenz hinzu, nicht mehr. Das Verhalten, die Validierung und die API der Wertobjekte sind vollständig eigenständig.
• Kein ORM und keine Sammlung von Entitäten. Es stellt Spaltentypen bereit. Ihre Entitäten, Mappings und Repositories bleiben Ihre.
• Nicht nur für Laravel. Siehe Verwendung außerhalb von Laravel .

Eine Full-Stack-Plattform, die für ein Bau- und Tiefbauunternehmen in Portugal entwickelt wurde – sie vereint die öffentliche Website, das Projektportfolio, die Personalbeschaffung, Nachrichten und Kundenreferenzen in einer einzigen, zusammenhängenden Laravel-Anwendung.

Die Architektur basiert auf abgegrenzten Kontexten, die die realen Domänen des Unternehmens abdecken (Unternehmensinformationen, Projekte, Rekrutierung, Nachrichten, Erfahrungsberichte, Benachrichtigungen und mehr) und folgt dem ereignisgesteuerten domänengesteuerten Design und der Clean Architecture. Eine dedizierte, warteschlangenbasierte Pipeline entkoppelt Seiteneffekte von der Kerndomänenlogik.

Vollständig getestet über die gesamte Pyramide hinweg – Unit, Integration, Funktionalität, Feature, System und E2E.

Laravel-Wrapper für die PHP-Exception-Bibliothek, der die Fehlerbehandlung von Laravel integriert und ein Rendered-Objekt für diese Ausnahmen bereitstellt.

php-exceptions-laravel

Laravel-Verkabelung und JSON-/Web-Renderer für den Ausnahmebaum der Domäne hradigital/php-exceptions .

Die Basisbibliothek liefert plattformunabhängige Ausnahmen – AbstractBaseException sowie die Bäume Client/ und Server/ , die auf die HTTP 4xx/5xx-Semantik abgestimmt sind – und weiß nichts über ein Transportprotokoll, sodass jede Anwendung aufs Neue entscheiden muss, wie eine ausgelöste Domänenausnahme zu einer Antwort wird.

Dieses Paket legt dies einmalig fest. API-Anfragen erhalten einen einheitlichen JSON-Body; Webanfragen, die einen 422-Fehler zurückgeben, werden mit Fehlern und den alten Eingaben an das Ursprungsformular zurückgesendet; jede andere Paketausnahme wird im Web mit dem entsprechenden HTTP-Statuscode beantwortet. Eine Ausnahme, deren Wert nicht AbstractBaseException ist, wird unverändert an den Laravel-eigenen Fehlerbehandler weitergeleitet.

• ExceptionRenderer - der JSON-Strategie-Dispatcher, der eine Ausnahme auf die erste Strategie auflöst, die sie unterstützt, mit einem immer passenden Fallback.
• WebRenderer - der Webstrategie-Dispatcher, der eine Ausnahme von der ersten Strategie, die diese unterstützt, auflöst, mit einem immer passenden Fallback.
• ExceptionsServiceProvider - automatisch erkannt, beide Dispatcher als Singletons gebunden und zwei renderable() Hooks im Ausnahmebehandler von Laravel registriert.
• API-Erkennung - eine gemeinsame Regel für beide Hooks: der Accept Header, ein JSON-Body, ein api/* Pfad oder ein api.* Routenname.
• Gebündelte Strategien - DefaultRenderer und InputFailureRenderer für JSON, InputFailureWebRenderer , UnprocessableEntityWebRenderer und DefaultWebRenderer für das Web.
• Benutzerdefinierte Strategien – lösen Sie das Singleton auf und fügen Sie Ihre eigene hinzu; die letzte Registrierung gewinnt.

Semantische, HTTP-konforme Domänenausnahmen für PHP 8.1+ DDD-Anwendungen – frameworkunabhängig, ohne Laufzeitabhängigkeiten

Zustandsbewusster clientseitiger Formularmanager für statische HTML-Formulare. Verfolgt den Status jedes Feldes (neu, unverändert, geändert, ungültig, leer) und passt die Symbolleistenaktionen entsprechend an.

@hradigital/smartforms

Zustandsbewusster clientseitiger Formularmanager für statische HTML-Formulare. Er erweitert das vom Server gerenderte HTML um reaktives Verhalten, ausschließlich über Attribute – wird beispielsweise eine <form> mit der Klasse smartform versehen, übernimmt das System die Kontrolle. Felder, Schaltflächen in der Symbolleiste und HTTP-Aktionen folgen dann dem Formularzustand, ohne dass React oder Vue benötigt werden und ohne dass der vom Server gesendete Markup verändert wird.

• Status pro Feld - verfolgt new , unchanged , changed , invalid und empty und wendet eine passende CSS-Klasse für die Formatierung an.
• Zwei Layouts – eine Liste von Datensätzen ( smartformlist ) oder ein einzelner Datensatz ( smartformrecord ).
• Toolbar-Verkabelung – Aktiviert und deaktiviert die Schaltflächen Erstellen, Aktualisieren, Löschen und Abbrechen vom Gesamtstatus des Formulars aus.
• HTTP-Tasks – bindet eine Toolbar-Aktion an ein Verb und einen Endpunkt, die im Markup deklariert sind.
• formStateChange Ereignisse - ein Übergang von CustomEvent pro Zustand, für alles, was die Bibliothek nicht abdeckt.
• Kein Framework, kein Build-Schritt – ESM, CJS und ein UMD-Build, der direkt aus einem <script> Tag geladen werden kann.

Installation

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

Oder laden Sie den UMD-Build direkt im Browser:

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

hradigital.com ist mein persönliches Ingenieurportfolio, das als Erweiterung meines Lebenslaufs und LinkedIn-Profils und nicht als statische Seite konzipiert wurde. Es handelt sich um eine Laravel-Anwendung mit sechs Sprachen (EN/PT/FR/ES/DE/NL), die nach denselben Prinzipien des ereignisgesteuerten, domänengesteuerten Designs und der Clean Architecture entwickelt wurde, die ich auch in produktiven Fintech-Systemen anwende – klare Trennung zwischen Anwendungs-, Domänen-, Framework- und Infrastrukturschichten gemäß dem SOLID-Prinzip.

Die Website ruft dynamisch Live-Inhalte ab und zeigt diese an, anstatt sie fest zu programmieren. Die gesamte Anbindung erfolgt über REST-API-Integrationen. Die Website wurde umfassend auf allen Ebenen getestet – von Unit-, Integrations-, Feature-, Funktions- und Systemtests bis hin zu End-to-End-Tests – und spiegelt dieselbe Entwicklungsmethodik wider, die ich auch bei Kundenprojekten anwende: abgegrenzte Kontexte, Domänenereignisse und eine Infrastruktur, die den eigentlichen Anwendungsfall nicht beeinträchtigt.

Unterstützen Sie die Wartung der aktuellen Fintech-Lösung und helfen Sie bei der Umstellung von Teilen des Systems auf eine Microservice-Architektur.

• Basierend auf LAMP (Laravel & Symfony).
• Klare Trennung zwischen Anwendungs- und Domänenschicht (sowie Framework und Infrastruktur).
• Domänengesteuertes Design und testgetriebene Entwicklung.
• Anwendung der besten Branchenstandards (Designmuster/Designprinzipien).

Entwicklung eines Handelsplattformprojekts für Transaktionen mit Finanzanlagen.

Ereignisgesteuertes Microservice-Projekt als Teil einer größeren Fintech-SaaS-Lösung, die Blockchain-Token und E-Wallet-Management umfasst. Basierend auf LAMP (Laravel).

• Entwicklung mit Microservice- und ereignisgesteuerter Architektur.
• Klare Trennung zwischen Anwendungs- und Domänenschicht.
• Domänengesteuertes Design und testgetriebene Entwicklung.
• Anwendung der besten Branchenstandards (Designmuster/Designprinzipien).

DDD-Bausteine für PHP: ein getestetes Trait pro Attribut sowie unveränderliche Werteobjekte vom Typ Str/int/float, Slug, Url, EmailAddress, Money und datetime. Framework-frei, keine Abhängigkeiten von Drittanbietern.

PHP-Datentypen

PHP Datatypes erstellt Ihre Wertobjekte, Entitäten und Aggregate aus vordefinierten, getesteten Traits – einem pro Attribut – wodurch die Klassendefinition für die dazugehörige Geschäftslogik frei bleibt.

Getter geben nach Möglichkeit Wertobjekte anstelle von primitiven Datentypen zurück. Dadurch verfügt jeder Wert über seine eigene Validierung und Normalisierung, anstatt dass sich jeder Aufrufer diese merken muss. Es gibt keine Abhängigkeiten von Drittanbietern außer PHP selbst, sodass diese Werte ohne Framework, HTTP-Anfrage oder Template-Engine funktionieren.

• AbstractValueObject - die Basis, von der ein Wertobjekt, eine Entität oder ein Aggregat erbt, wodurch es aus einem Array konstruiert wird, eine vollständige Serialisierung ermöglicht und standardmäßig toArray() erhält.
• Entitätsmerkmale - ein Merkmal pro Attribut ( HasPositiveIntegerIDTrait , HasActiveTrait , HasNameTrait , ...), das jeweils die Typhinweise und die Normalisierung für dieses Attribut enthält.
• Skalare Datentypen - unveränderliche Str , Integer- und Float-Wrapper, mit einer flüssigen API, die bei jeder Operation eine neue Instanz zurückgibt, anstatt den Wert direkt zu verändern.
• Web-Datentypen - Slug , Url und EmailAddress , die sich jeweils selbst validieren und normalisieren.
• Datums- und Zeitdatentypen – Datums- und Zeitwerte, ohne Einbindung einer Datums- und Zeitbibliothek.
• Ausnahmevokabular – eine typisierte Ausnahme pro Datentyp unter Exceptions\Datatypes\* , sodass ein abgelehnter Wert angibt, was abgelehnt wurde und warum.

Umfang

Dieses Paket enthält Datentypen: Werte, die sich selbst validieren und normalisieren und die jede PHP-Anwendung ohne Framework, HTTP-Anfrage oder Template-Engine verwenden kann. Die Regel „ Keine Abhängigkeiten von Drittanbietern “ ist sowohl eine Bereichs- als auch eine Abhängigkeitsregel.

Das Verhalten, das Dokumente rendert, parst oder zum Ausliefern einer Webseite dient, ist kein Datentyp, sondern befindet sich im Paket hradigital/php-markup . php-markup ist von diesem Paket abhängig – niemals umgekehrt.

Das Projekt basiert im Backend auf LAMP und dem Laravel-Framework. Es ist in verschiedene Pakete unterteilt, die in mehreren Projekten/Distributionen verwendet werden, darunter auch LRTT. Im Frontend setzen wir HTML5 mit Bootstrap und React ein.

Meine erste Aufgabe im Projekt war es, die Funktionalität für mehr Benutzerrollen anzupassen, das System für die Registrierung und Authentifizierung von Benutzern mit mehreren Rollen anzupassen, einen eigenen Bereich für eine neue Rolle zu erstellen und die API-Funktionalität für das Frontend zu entwickeln.

Im Frontend bestand die Aufgabe neben der Schaffung eines neuen, dedizierten Benutzerrollenbereichs darin, eine React-Anwendung zu entwickeln, die die Fellowship-Informationen für einen registrierten ehrenamtlichen Lehrer verwaltet.

Während der Entwicklung für dieses Projekt gehörte es zu meinen Aufgaben, Code auf die Syntax von PHP7 umzustellen und neuen sowie bestehenden Code mithilfe von PHPDocs zu dokumentieren.

Layout- und Datenbankrestrukturierung. Tabellenbasierte Neugestaltung und Weiterentwicklung der Unternehmenswebseiten mit neuen Funktionalitäten, einheitlichem Corporate Design und gemeinsam genutzten Ressourcen.