Inštalácia

Pridajte balík. Service provider sa zaregistruje automaticky cez package discovery a alias fasády Addresses pridá podľa konfigurácie — bez manuálnej registrácie:

composer require roundly-consulting/addresses-for-laravel

Publikovanie a spustenie migrácie

Migrácia sa len publikuje: balík ju nikdy nenačítava sám, takže php artisan migrate nevytvorí nič, kým ju nepublikujete. Skončí v database/migrations s časovou pečiatkou, publikovaná kópia patrí vám a môžete ju upravovať a opätovné publikovanie s --force prepíše ten istý súbor namiesto vytvorenia druhej kópie:

php artisan vendor:publish --tag="addresses-migrations"
php artisan migrate

Ak modely, ktoré budú vlastniť adresy, používajú UUID alebo ULID primárne kľúče, nastavte ADDRESSES_KEY_TYPE ešte pred spustením migrácie — typ kľúča sa zapíše do stĺpca addressable (pozrite Databázová schéma a typy kľúčov).

Publikovanie konfigurácie (voliteľné)

Každý kľúč má funkčnú predvolenú hodnotu, takže config/addresses.php publikujete, len ak chcete niektorý zmeniť:

php artisan vendor:publish --tag="addresses-config"

Balík vystavuje presne dva publish tagy — addresses-migrations a addresses-config. Nedodáva žiadne routy, views, preklady ani Artisan príkazy.

Kontrola nastavenia

Balík pridáva do php artisan about sekciu Addresses — model, tabuľku, predvolený typ, či je zapnutá normalizácia krajín, základný názov triedy resolvera (alebo NONE) a alias fasády (alebo DISABLED); nesprávne nastavený predvolený typ, resolver či alias sa zobrazí ako INVALID. Uložené adresy sa v nej nikdy nezobrazia:

php artisan about --only=addresses

Ďalšie kroky

• Pridajte trait HasAddresses každému modelu, ktorý vlastní adresy.
• Adresy vytvárajte fluentným builderom alebo cez DTO AddressData.
• Čítajte ich cez primaryAddress(), addressesOfType() alebo query scopy.