--- title: "Addresses for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Addresses for Laravel: polymorfné adresy, typy adries, primárne adresy, ISO kódy krajín, udalosti a testovacie pomôcky." url: https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Addresses for Laravel Inštalácia `composer require roundly-consulting/addresses-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/addresses-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/addresses-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Adresy pre akýkoľvek Eloquent model, natívne v Laraveli. Pridajte trait HasAddresses a pripojte toľko fakturačných, dodacích, domácich či kancelárskych adries, koľko potrebujete — všetky v jednej polymorfnej tabuľke addresses, vytvorené fluentným builderom alebo cez DTO, typované enumom AddressType, s najviac jednou primárnou adresou na typ, povyšovanou atomicky, a s ISO kódmi krajín normalizovanými už pri zápise. Súčasťou sú query scopy, udalosti životného cyklu, API resource a testovacie pomôcky. Licencia MIT, postavené len na Laraveli a vlastnom package toolkite Roundly — bez závislostí tretích strán a bez sieťových volaní. ### Čo získate #### Adresy na akomkoľvek modeli Jeden trait a jedna polymorfná tabuľka dajú akémukoľvek Eloquent modelu fakturačné, dodacie či kancelárske adresy — pre vlastníkov s bigint, UUID aj ULID kľúčmi. #### Typované typy adries Enum AddressType — default, billing, shipping, home, work, office — s popiskami pre UI. Nikde v API žiadne typy ako voľné reťazce. #### Jedna primárna na typ Povýšenie adresy atomicky, pod zámkom skupiny vlastník + typ, zruší primárny príznak ostatným; adresu iného vlastníka či zmazanú adresu odmietne. #### Fasáda, DI alebo akcie Addresses::for($customer)->new()->in(…)->at(…)->save() sa číta ako veta; rovnaký výsledok dosiahnete aj cez AddressManager alebo akciu. #### Normalizácia ISO krajín Kódy sa pri zápise orežú, prevedú na veľké písmená a overí sa ich tvar. Názvy a geokódovanie doplní váš CountryResolver — bez sieťových volaní. #### Udalosti, scopy a API resource Štyri udalosti životného cyklu, query scopy primary/ofType/inCountry a stabilný AddressResource pre JSON API. #### Zaznamenávajúci fake a pomôcky Addresses::fake() zaznamená každý zápis bez zásahu do databázy; k tomu assertHasAddress(), assertPrimaryAddress() a AddressFactory. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/instalacia.md) Inštalácia cez Composer, publikovanie a spustenie migrácie adries (typ kľúča UUID či ULID nastavte vopred) a voliteľne publikovanie config/addresses.php. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/konfiguracia.md) Každý konfiguračný kľúč a jeho predvolená hodnota — model adresy, typ kľúča vlastníka, predvolený typ, normalizácia krajín, resolver a alias. #### [Databázová schéma a typy kľúčov](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/databazova-schema.md) Tabuľka addresses stĺpec po stĺpci a ako key\_type určuje polymorfný stĺpec vlastníka pre modely s kľúčmi bigint, UUID alebo ULID. #### [Trait HasAddresses](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/trait-has-addresses.md) Pridajte HasAddresses akémukoľvek Eloquent modelu a získate polymorfný vzťah addresses a pomocníkov na vytváranie, čítanie a primárne adresy. #### [Typy adries](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/typy-adries.md) Enum AddressType — šesť prípadov s popiskami pre UI — a ako bezpečne previesť nedôveryhodné reťazce z requestov. #### [Fasáda Addresses](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/fasada.md) Addresses::for($owner) vráti adresár vlastníka pre akýkoľvek model; update, delete a countryName pracujú s jednou adresou. #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/bez-fasady.md) Bez fasády: injektujte AddressManager alebo spustite niektorú zo štyroch akcií priamo — mapa metód fasády na akcie. #### [AddressData a CreateAddressAction](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/dto-a-akcie.md) Zápisy cez DTO AddressData — make(), predvolené hodnoty a záložný default\_type — alebo createAddress() a CreateAddressAction na akomkoľvek modeli. #### [Fluentný builder](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/fluentny-builder.md) Vytvárajte adresy cez Addresses::for()->new() alebo newAddress() — čitateľná reťaz PendingAddress, ktorá neprepustí neúplnú adresu. #### [Čítanie adries](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/citanie-adries.md) Načítajte všetky adresy, prvú alebo primárnu adresu daného typu, kolekciu jedného typu alebo rýchlu kontrolu existencie. #### [Primárne adresy](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/primarne-adresy.md) Jedna primárna adresa na vlastníka a typ — povýšenie, zrušenie, nastavenie pri vytvorení a ochrana pred adresou iného vlastníka. #### [Query scopy](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/scopy-dopytov.md) Filtrujte adresy scopmi primary(), ofType() a inCountry() — na modeli, na vzťahu ľubovoľného vlastníka alebo v kombinácii. #### [Model Address](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/model-adresy.md) Atribúty, casty, vzťah na vlastníka, JSON meta a jednoriadkový popis formatted() na modeli Address. #### [Úprava a mazanie](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/uprava-a-mazanie.md) Upravujte cez Addresses::update() s úplným AddressData, adresy mäkko mažte a obnovujte a upracte ich, keď vlastník zanikne. #### [Kódy krajín a resolvery](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/krajiny.md) Normalizácia ISO kódov krajín pri každom zápise a voliteľný CountryResolver pre názvy a geokódovanie — bez pribalených dát a sieťových volaní. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/udalosti.md) AddressCreated, AddressUpdated, AddressDeleted a PrimaryAddressChanged — kedy sa ktorá odošle, prečo čakajú na commit a ako ich počúvať. #### [API resource](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/api-vystup.md) AddressResource vykreslí adresu pre JSON API v stabilnom tvare — riadky adresy, krajina, primárny príznak, formátovaný popis a meta. #### [Vlastný model adresy](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/vlastny-model.md) Cez konfiguráciu nasaďte vlastnú podtriedu Address so scopmi, vzťahmi či castmi — každá cesta balíka ju použije. #### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/vynimky.md) Jedna základná AddressesException a päť typovaných výnimiek — neúplná adresa, neplatná krajina, cudzia adresa, zmazaná adresa a neplatný typ. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/testovanie.md) Zaznamenávajúci Addresses::fake(), asercie InteractsWithAddresses, AddressFactory so stavmi billing, shipping a primary a príklad v Peste. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/addresses-for-laravel/poziadavky.md) PHP 8.4+ a Laravel 12 alebo 13 — bez PHP rozšírení, bez závislostí tretích strán a bez sieťových volaní. ## Prejavte lásku k open source Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať. [Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md) Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md). [Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly) ## Chcete to zabudovať do svojho produktu? Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín. [Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)