Inštalácia

Pridajte balík cez Composer. Service provider sa zaregistruje automaticky — bez manuálnej registrácie:

composer require roundly-consulting/money-for-laravel

Ak má vaša aplikácia vypnuté package discovery, zaregistrujte RoundlyConsulting\Money\MoneyServiceProvider sami. Nevynechávajte ho: migrácie iných balíkov volajú makro $table->money() a bez providera zlyhajú.

// bootstrap/providers.php — only when package discovery is disabled
return [
    App\Providers\AppServiceProvider::class,
    RoundlyConsulting\Money\MoneyServiceProvider::class,
];

Publikovanie

Konfiguračný súbor je voliteľný — každý kľúč má rozumnú predvolenú hodnotu a tie bežné sa dajú nastaviť cez env. Publikujte ho, len ak chcete niečo zmeniť:

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

Migráciu publikujte a spustite len vtedy, ak používate driver kurzov database (alebo chain) — vytvorí tabuľku money_exchange_rates. Nič sa nenačítava automaticky:

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

Voliteľne publikujte validačné hlášky (balík obsahuje angličtinu a slovenčinu):

php artisan vendor:publish --tag="money-translations"

• money-config — config/money.php.
• money-migrations — migrácia create_money_exchange_rates_table, pri publikovaní dostane časovú pečiatku.
• money-translations — lang/vendor/money/{en,sk}/validation.php.

Pred prvou migráciou so sumami

money.schema.currency_length a money.schema.precision sa čítajú pri spúšťaní migrácií a potom sú nemenné. Nastavte ich skôr, než spustíte migráciu s makrami pre peňažné stĺpce — napríklad zvýšte currency_length predtým, ako budete ukladať vlastné kódy typu USDT.

Prehľad nastavenia

Balík pridáva do príkazu about sekciu Money — nikdy v nej nie sú prístupové údaje providerov:

php artisan about   # the "Money" section: default currency, currency counts,
                    # formatter, exchange driver and rate schedule

Statická analýza

Balík obsahuje rozšírenie pre PHPStan (extension.neon, sprístupnené cez extra.phpstan.includes). S phpstan/extension-installer PHPStan automaticky pozná makrá Blueprintu money() / moneyJson() / currencyCode(), makrá kolekcií aj Request::money().