Bewaar PHP-datatype-waardeobjecten met Doctrine DBAL - automatisch geïnjecteerd in Laravel, geen configuratie nodig.

php-datatypes-laravel-doctrine

Dit pakket maakt het mogelijk om een object van het type hradigital/php-datatypes als gedeclareerd type voor een Doctrine Entity-attribuut te gebruiken. Doctrine bewaart alleen de typen die het zelf meelevert, dus een EmailAddress , een Money of een Address zou anders als primitief type gedeclareerd en handmatig geconverteerd moeten worden bij elke lees- en schrijfbewerking. Het pakket levert één Doctrine DBAL-type per Datatypes-object, plus een Laravel Service Provider die ze allemaal registreert, zodat de Entity het Value-object bevat, terwijl de database een eenvoudige, indexeerbare en leesbare waarde behoudt.

• Doctrine DBAL-typen - één per Datatypes-object: StrType , EmailAddressType , UrlType , SlugType , DatetimeType , CurrencyType , MoneyType , AddressType en de rest.
• De standaard PHP-typen zijn NativeDateTimeType , NativeDateTimeImmutableType , NativeDateIntervalType en NativeDateTimeZoneType , dus een entiteit die een eenvoudig type \DateTime bevat, wordt volgens dezelfde naamgevingsconventie toegewezen.
• Laravel Service Provider - automatisch gedetecteerd, registreert elk type voordat een EntityManager een mapping oplost. Niets te publiceren, niets te configureren.
• Een naamgevingsregel : de naam van een Doctrine-type is altijd de korte naam van de Type-klasse zelf.
• Validatie tijdens het invoeren - een validatiefout van een waardeobject wordt weergegeven als een DBAL ConversionException , waardoor een ongeldige waarde wordt afgewezen in plaats van de kolom te beschadigen.
• Framework-optioneel - de typen zijn standaard DBAL-typen zonder frameworkafhankelijkheid; de serviceprovider is een extraatje.

Wat dit pakket niet is

• Dit is geen fork of vervanging voor hradigital/php-datatypes Het is ervan afhankelijk en voegt persistentie toe, meer niet. Het gedrag, de validatie en de API van de Value Objects zijn volledig van hen.
• Het is geen ORM en ook geen verzameling entiteiten. Het voegt kolomtypen toe. Uw entiteiten, mappings en repositories blijven van u.
• Niet alleen voor Laravel. Zie Gebruik buiten Laravel .

Een volledig geïntegreerd platform, gebouwd voor een bouw- en civieltechnisch bedrijf in Portugal, dat hun publieke website, projectportfolio, werving, nieuws en klantrecensies samenbrengt in één samenhangende Laravel-applicatie.

De architectuur is opgebouwd rond afgebakende contexten die de daadwerkelijke domeinen van het bedrijf bestrijken (bedrijfsinformatie, projecten, werving, nieuws, getuigenissen, meldingen en meer), volgens de principes van event-driven en domain-driven design en clean architecture, met een speciale, op wachtrijen gebaseerde pipeline die neveneffecten scheidt van de kerndomeinlogica.

Volledig getest op alle niveaus: unit, integratie, functionaliteit, kenmerken, systeem en end-to-end.

Een Laravel-wrapper voor de PHP-Exception-bibliotheek, die de foutafhandeling van Laravel integreert en een Rendered-object biedt voor deze uitzonderingen.

php-exceptions-laravel

Laravel-implementatie en JSON/web-renderers voor de uitzonderingsstructuur van domein hradigital/php-exceptions .

De basisbibliotheek levert platformonafhankelijke uitzonderingen - AbstractBaseException en de Client/ en Server/ bomen, afgestemd op de HTTP 4xx/5xx-semantiek - en weet niets over een transportprotocol. Hierdoor moet elke applicatie zelf bepalen hoe een gegenereerde domeinuitzondering een reactie wordt.

Dit pakket bepaalt het eenmalig. API-verzoeken krijgen een uniforme JSON-body; webverzoeken die een 422-foutmelding geven, komen terug op het oorspronkelijke formulier met fouten en oude invoer; elke andere uitzondering van het pakket wordt op het web beantwoord met de HTTP-status die het declareert. Een uitzondering die niet van de klasse AbstractBaseException is, wordt ongewijzigd doorgestuurd naar de eigen handler van Laravel.

• ExceptionRenderer - de JSON-strategiedispatcher, die een uitzondering oplost door de eerste strategie te gebruiken die deze ondersteunt, met een altijd passende terugvaloptie.
• WebRenderer - de webstrategiedispatcher, die een uitzondering afhandelt door de eerste strategie te gebruiken die deze ondersteunt, met een altijd passende terugvaloptie.
• ExceptionsServiceProvider - automatisch gedetecteerd, waarbij beide dispatchers als singletons worden gebonden en twee renderable() hooks worden geregistreerd op de exception handler van Laravel.
• API-detectie - één gedeelde regel voor beide hooks: de header Accept , een JSON-body, een pad api/* ) of een routenaam api.* .
• Gebundelde strategieën - DefaultRenderer en InputFailureRenderer voor JSON, InputFailureWebRenderer , UnprocessableEntityWebRenderer en DefaultWebRenderer voor het web.
• Aangepaste strategieën - los de singleton op en voeg je eigen waarde toe; de laatst geregistreerde waarde wint.

Semantische, HTTP-conforme domeinuitzonderingen voor PHP 8.1+ DDD-applicaties - framework-onafhankelijk, geen runtime-afhankelijkheden

php-uitzonderingen

Een zorgvuldig samengestelde set herbruikbare, semantische domeinuitzonderingen voor Domain-Driven Design PHP-applicaties. De namen zijn gebaseerd op de HTTP 4XX/5XX-families, omdat die terminologie algemeen bekend is. De uitzonderingen worden echter gegenereerd op de domeinlaag, buiten elk transportmechanisme, en aan de grens vertaald naar een HTTP-antwoord, RPC-fout, CLI-exit of deadletter-bericht in de wachtrij. Het genereren van de juiste uitzondering maakt deel uit van je domeintaal, terwijl een generieke InvalidArgumentException die taal verstoort. Framework-agnostisch, zonder runtime-afhankelijkheden buiten de PHP-standaardbibliotheek, voor elk PHP 8.1+-project.

• Clientuitzonderingen - fouttypen van de aanroeper, afgestemd op de 4XX-reeks, van BadRequestException tot en met UnavailableForLegalReasonsException , elk met een standaardbericht en statuscode.
• Serveruitzonderingen - systeemfouttypen die overeenkomen met de 5XX-familie, van InternalServerErrorException tot en met LoopDetectedException .
• AbstractBaseException - de gemeenschappelijke basis, die de native \DomainException van PHP uitbreidt, zodat één enkele catch alles in dit pakket omvat.
• Request\RequestFailureException - gestructureerde validatiefouten per veld, voor één afgekeurde lading met diverse oorzaken.
• Uitbreiding op basis van intentie - elk type is bedoeld om te worden uitgebreid met een eigen, benoemde uitzondering, zodat aanroepers de bredere intentie nog steeds kunnen opvangen.

Vereisten

Installatie

composer require hradigital/php-exceptions

Gebruik

Elke uitzondering in dit pakket erft van AbstractBaseException , dat zelf weer een uitbreiding is van PHP's native \DomainException Elke subklasse wordt geleverd met een zinvol standaardbericht en een HTTP-compatibele statuscode ( $code ).

use HraDigital\Components\Exceptions\Client\NotFoundException;

throw new NotFoundException('User #42 does not exist.');

Een client-side formulierbeheerder die rekening houdt met de status van statische HTML-formulieren. Houdt de status van elk veld bij (nieuw, ongewijzigd, gewijzigd, ongeldig, leeg) en schakelt de acties in de werkbalk dienovereenkomstig in of uit.

@hradigital/smartforms

Een state-aware client-side formulierbeheerder voor statische HTML-formulieren. Het voegt reactief gedrag toe aan de HTML die een server-rendered applicatie al produceert, volledig aangestuurd door attributen - markeer een <form> met de klasse smartform en het neemt het over. Velden, toolbarknoppen en HTTP-acties volgen vervolgens de state van het formulier, zonder React of Vue en zonder de markup die de server al verzendt te herschrijven.

• Per-veldstatus - houdt new , unchanged , changed , invalid en empty bij en past een overeenkomende CSS-klasse toe voor de styling.
• Twee lay-outs - een lijst met records ( smartformlist ) of een enkel record ( smartformrecord ).
• Werkbalkconfiguratie - hiermee kunt u de knoppen voor aanmaken, bijwerken, verwijderen en annuleren in- en uitschakelen in de algemene status van het formulier.
• HTTP-taken - koppelt een actie in de werkbalk aan een werkwoord en eindpunt, zoals gedeclareerd in de markup.
• formStateChange gebeurtenissen - een CustomEvent per toestandsovergang, voor alles wat de bibliotheek niet dekt.
• Geen framework, geen build-stap - ESM, CJS en een UMD-build die direct vanuit een <script> tag geladen kan worden.

Installatie

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

Of laad de UMD-build direct in de browser:

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

hradigital.com is mijn persoonlijke portfolio als ontwikkelaar, bedoeld als een functionele uitbreiding van mijn cv en LinkedIn-profiel in plaats van een statische pagina. Het is een Laravel-applicatie met ondersteuning voor zes talen (EN/PT/FR/ES/DE/NL), ontworpen volgens dezelfde principes van event-driven en domain-driven design en clean architecture die ik toepas in fintech-systemen in productie: een duidelijke scheiding tussen applicatie-, domein-, framework- en infrastructuurlagen, conform de SOLID-methode.

De site haalt actief live, dynamische content op en toont deze in plaats van deze hard te coderen, allemaal gekoppeld via REST API-integraties. De site is volledig getest volgens de hele piramide – unit-, integratie-, feature-, functionele, systeem- en end-to-end-testen – en weerspiegelt dezelfde technische discipline die ik toepas bij mijn werk voor klanten: afgebakende contexten, domeingebeurtenissen en een infrastructuur die het domein niet in de weg staat.

Help mee met het onderhouden van de huidige fintech-oplossing en help bij de overgang van delen van het systeem naar een microservice-architectuur.

• Gebaseerd op LAMP (Laravel & Symfony).
• Duidelijke scheiding tussen applicatie- en domeinlagen (en framework en infrastructuur).
• Domeingedreven ontwerp en testgedreven ontwikkeling.
• Het toepassen van de beste industriestandaarden (ontwerppatronen/ontwerpprincipes).

Het ontwikkelen van een handelsplatform voor transacties met financiële activa.

Een event-driven microservice-project, onderdeel van een grotere Fintech SaaS-oplossing, met blockchain-tokens en e-walletbeheer. Gebaseerd op LAMP (Laravel).

• Ontwikkelen met behulp van microservices en een gebeurtenisgestuurde architectuur.
• Duidelijke scheiding tussen de applicatielaag en de domeinlaag.
• Domeingedreven ontwerp en testgedreven ontwikkeling.
• Het toepassen van de beste industriestandaarden (ontwerppatronen/ontwerpprincipes).

DDD-bouwstenen voor PHP: één geteste Trait per attribuut, plus onveranderlijke Value Objects voor Str/int/float, Slug, Url, EmailAddress, Money en datetime. Framework-vrij, geen afhankelijkheid van derden.

PHP-datatypen

PHP Datatypes bouwt uw waardeobjecten, entiteiten en aggregaties op basis van vooraf gedefinieerde, geteste traits - één per attribuut - waardoor de klassedefinitie vrij blijft voor de bedrijfslogica die erbij hoort.

Getters retourneren, waar mogelijk, waardeobjecten in plaats van primitieve gegevenstypen, waardoor een waarde zijn eigen validatie en normalisatie bevat in plaats van dat elke aanroeper deze moet onthouden. Er is geen afhankelijkheid van derden buiten PHP zelf, dus deze waarden werken zonder framework, HTTP-verzoek of template-engine.

• AbstractValueObject - de basis die een Waardeobject, Entiteit of Aggregaat uitbreidt, waardoor het kan worden opgebouwd vanuit een array, volledig kan worden geserialiseerd en toArray() bruikbaar is.
• Entiteitskenmerken - één kenmerk per attribuut ( HasPositiveIntegerIDTrait , HasActiveTrait , HasNameTrait , ...), elk met de type-hints en normalisatie voor dat attribuut.
• Scalaire gegevenstypen - onveranderlijke wrappers Str gehele getallen en drijvende-kommagetallen, met een vloeiende API die bij elke bewerking een nieuwe instantie retourneert in plaats van de waarde ter plaatse te wijzigen.
• Webdatatypen - Slug , Url en EmailAddress , die elk zichzelf valideren en normaliseren.
• Datum- en tijdgegevenstypen - datum- en tijdwaarden, zonder een datum- en tijdbibliotheek te hoeven gebruiken.
• Uitzonderingsvocabulaire - een getypte uitzondering per gegevenstype onder Exceptions\Datatypes\* , zodat een afgewezen waarde aangeeft wat er is afgewezen en waarom.

Domein

Dit pakket bevat gegevenstypen: waarden die zichzelf valideren en normaliseren, en die elke PHP-applicatie kan gebruiken zonder framework, HTTP-verzoek of template-engine. De regel " Geen afhankelijkheid van derden " is zowel een scope-regel als een afhankelijkheidsregel.

Gedrag dat documenten weergeeft, parseert of een webpagina serveert, is geen gegevenstype en valt onder hradigital/php-markup . php-markup is afhankelijk van dit pakket - nooit andersom.

Het project is gebaseerd op LAMP aan de back-end, bovenop het Laravel-framework. Het project is opgedeeld in verschillende pakketten die in meerdere projecten/distributies worden gebruikt, waaronder dat van LRTT. Aan de front-end gebruiken we HTML5 met Bootstrap en React.

Mijn eerste opdracht binnen het project was het aanpassen van de functionaliteit voor meer gebruikersrollen, het aanpassen van het systeem voor registratie en authenticatie van gebruikers met meerdere rollen, het creëren van een aparte omgeving voor een nieuwe rol en het ontwikkelen van API-functionaliteit voor de front-end.

Aan de front-end was het, naast het creëren van een nieuwe, specifieke gebruikersomgeving, de bedoeling om een React-applicatie te ontwikkelen die de informatie van Fellowship beheert voor een geregistreerde vrijwillige docent.

Tijdens de ontwikkeling van dit project was een van mijn taken het migreren van code naar de PHP7-syntaxis en het documenteren van nieuwe en bestaande code met behulp van PHPDocs.

Herstructurering van de lay-out en de database. Herontwerp en herontwikkeling van de bedrijfswebsites op basis van tabellen, met nieuwe functionaliteiten, behoud van dezelfde huisstijl en gedeelde resources.