# cknow/laravel-money architecture

> Architecture diagram of the GitHub repository cknow/laravel-money, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cknow/laravel-money
- Repository: https://github.com/cknow/laravel-money

## Overview

Laravel Money wraps MoneyPHP for Laravel applications: callers construct currency-specific values or parse user input into the Money object, then format, serialize, validate, or persist them through Laravel casts. Configuration controls default locale/currency and supported currency sets; service-provider bootstrapping exposes configuration, Blade directives, and validation rules. The graph includes the documented casting and helper capabilities, but source excerpts for helpers and several cast implementations were not shown, so their internal calls are not asserted.

Main entry points: [`src/Money.php`](https://github.com/cknow/laravel-money/blob/main/src/Money.php) (Money Value), [`src/MoneyServiceProvider.php`](https://github.com/cknow/laravel-money/blob/main/src/MoneyServiceProvider.php) (Service Provider), [`src/CurrenciesTrait.php`](https://github.com/cknow/laravel-money/blob/main/src/CurrenciesTrait.php) (Currency Registry), [`src/Rules`](https://github.com/cknow/laravel-money/tree/main/src/Rules) (Validation Rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Money Core"]
  node_money["Money Value<br/>[Money.php]"]
  node_factory["Currency Factory<br/>[MoneyFactory.php]"]
end

subgraph group_currencies["Currency Setup"]
  node_currencies["Currency Registry"]
  node_iso["ISO Currency Data<br/>[ISOCurrencies.php]"]
  node_config["Package Defaults<br/>[config.php]"]
end

subgraph group_presentation["Input and Output"]
  node_parser["Money Parsing"]
  node_formatter["Money Formatting"]
  node_symbol["Symbol Formatter"]
  node_serializer["Serialization"]
  node_arrayserializer["Array Serializer"]
end

subgraph group_laravel["Laravel Integration"]
  node_casts["Eloquent Money Casts"]
  node_rules["Validation Rules"]
  node_currencyrule["Currency Rule<br/>[Currency.php]"]
  node_blade["Blade Directives<br/>[BladeExtension.php]"]
  node_provider["Service Provider"]
end

node_application(("Laravel Application"))
node_moneyphp["MoneyPHP"]
node_validator["Laravel Validator"]

node_application -->|"creates or parses"| node_money
node_money -->|"dispatches factories"| node_factory
node_money -->|"parses input"| node_parser
node_money -->|"formats values"| node_formatter
node_money -->|"serializes values"| node_serializer
node_money -->|"uses currency setup"| node_currencies
node_parser -->|"uses parsers"| node_moneyphp
node_money -->|"delegates arithmetic"| node_moneyphp
node_currencies -->|"constructs ISO registry"| node_iso
node_currencies -->|"reads defaults"| node_config
node_formatter -->|"uses formatter"| node_symbol
node_serializer -->|"uses serializer"| node_arrayserializer
node_application -->|"casts model values"| node_casts
node_application -->|"validates fields"| node_rules
node_rules -->|"provides currency rule"| node_currencyrule
node_currencyrule -->|"checks currency"| node_money
node_provider -->|"merges configuration"| node_config
node_provider -->|"registers directives"| node_blade
node_provider -->|"registers rules"| node_validator
node_validator -->|"invokes rules"| node_rules

click node_money "https://github.com/cknow/laravel-money/blob/main/src/Money.php"
click node_factory "https://github.com/cknow/laravel-money/blob/main/src/MoneyFactory.php"
click node_parser "https://github.com/cknow/laravel-money/blob/main/src/MoneyParserTrait.php"
click node_formatter "https://github.com/cknow/laravel-money/blob/main/src/MoneyFormatterTrait.php"
click node_symbol "https://github.com/cknow/laravel-money/blob/main/src/Formatters/CurrencySymbolMoneyFormatter.php"
click node_serializer "https://github.com/cknow/laravel-money/blob/main/src/MoneySerializerTrait.php"
click node_arrayserializer "https://github.com/cknow/laravel-money/blob/main/src/Serializer/ArrayMoneySerializer.php"
click node_currencies "https://github.com/cknow/laravel-money/blob/main/src/CurrenciesTrait.php"
click node_iso "https://github.com/cknow/laravel-money/blob/main/src/Currencies/ISOCurrencies.php"
click node_config "https://github.com/cknow/laravel-money/blob/main/config/config.php"
click node_casts "https://github.com/cknow/laravel-money/tree/main/src/Casts"
click node_rules "https://github.com/cknow/laravel-money/tree/main/src/Rules"
click node_currencyrule "https://github.com/cknow/laravel-money/blob/main/src/Rules/Currency.php"
click node_blade "https://github.com/cknow/laravel-money/blob/main/src/BladeExtension.php"
click node_provider "https://github.com/cknow/laravel-money/blob/main/src/MoneyServiceProvider.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_money,node_factory toneBlue
class node_currencies,node_iso,node_config toneAmber
class node_parser,node_formatter,node_symbol,node_serializer,node_arrayserializer toneMint
class node_casts,node_rules,node_currencyrule,node_blade,node_provider toneRose
class node_application,node_moneyphp,node_validator toneIndigo
```

## Components

### Money Core

- [Money Value](https://github.com/cknow/laravel-money/blob/main/src/Money.php): `src/Money.php`
- [Currency Factory](https://github.com/cknow/laravel-money/blob/main/src/MoneyFactory.php): `src/MoneyFactory.php`

### Currency Setup

- [Currency Registry](https://github.com/cknow/laravel-money/blob/main/src/CurrenciesTrait.php): `src/CurrenciesTrait.php`
- [ISO Currency Data](https://github.com/cknow/laravel-money/blob/main/src/Currencies/ISOCurrencies.php): `src/Currencies/ISOCurrencies.php`
- [Package Defaults](https://github.com/cknow/laravel-money/blob/main/config/config.php): `config/config.php`

### Input and Output

- [Money Parsing](https://github.com/cknow/laravel-money/blob/main/src/MoneyParserTrait.php): `src/MoneyParserTrait.php`
- [Money Formatting](https://github.com/cknow/laravel-money/blob/main/src/MoneyFormatterTrait.php): `src/MoneyFormatterTrait.php`
- [Symbol Formatter](https://github.com/cknow/laravel-money/blob/main/src/Formatters/CurrencySymbolMoneyFormatter.php): `src/Formatters/CurrencySymbolMoneyFormatter.php`
- [Serialization](https://github.com/cknow/laravel-money/blob/main/src/MoneySerializerTrait.php): `src/MoneySerializerTrait.php`
- [Array Serializer](https://github.com/cknow/laravel-money/blob/main/src/Serializer/ArrayMoneySerializer.php): `src/Serializer/ArrayMoneySerializer.php`

### Laravel Integration

- [Eloquent Money Casts](https://github.com/cknow/laravel-money/tree/main/src/Casts): `src/Casts`
- [Validation Rules](https://github.com/cknow/laravel-money/tree/main/src/Rules): `src/Rules`
- [Currency Rule](https://github.com/cknow/laravel-money/blob/main/src/Rules/Currency.php): `src/Rules/Currency.php`
- [Blade Directives](https://github.com/cknow/laravel-money/blob/main/src/BladeExtension.php): `src/BladeExtension.php`
- [Service Provider](https://github.com/cknow/laravel-money/blob/main/src/MoneyServiceProvider.php): `src/MoneyServiceProvider.php`

### Other components

- **Laravel Application**
- **MoneyPHP**
- **Laravel Validator**

## Connections

- Laravel Application → Money Value: creates or parses (evidence: `README.md`)
- Money Value → Currency Factory: dispatches factories (evidence: `src/Money.php`)
- Money Value → Money Parsing: parses input (evidence: `src/Money.php`)
- Money Value → Money Formatting: formats values (evidence: `src/Money.php`)
- Money Value → Serialization: serializes values (evidence: `src/Money.php`)
- Money Value → Currency Registry: uses currency setup (evidence: `src/Money.php`)
- Money Parsing → MoneyPHP: uses parsers (evidence: `src/MoneyParserTrait.php`)
- Money Value → MoneyPHP: delegates arithmetic (evidence: `src/Money.php`)
- Currency Registry → ISO Currency Data: constructs ISO registry (evidence: `src/CurrenciesTrait.php`)
- Currency Registry → Package Defaults: reads defaults (evidence: `src/CurrenciesTrait.php`)
- Money Formatting → Symbol Formatter: uses formatter (evidence: `src/MoneyFormatterTrait.php`)
- Serialization → Array Serializer: uses serializer (evidence: `src/MoneySerializerTrait.php`)
- Laravel Application → Eloquent Money Casts: casts model values (evidence: `README.md`)
- Laravel Application → Validation Rules: validates fields (evidence: `README.md`)
- Validation Rules → Currency Rule: provides currency rule (evidence: `src/Rules/Currency.php`)
- Currency Rule → Money Value: checks currency (evidence: `src/Rules/Currency.php`)
- Service Provider → Package Defaults: merges configuration (evidence: `src/MoneyServiceProvider.php`)
- Service Provider → Blade Directives: registers directives (evidence: `src/MoneyServiceProvider.php`)
- Service Provider → Laravel Validator: registers rules (evidence: `src/MoneyServiceProvider.php`)
- Laravel Validator → Validation Rules: invokes rules
