PHPackages red-jasmine/money - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. red-jasmine/money ActiveLibrary[Utility & Helpers](/categories/utility) red-jasmine/money ================= Red Jasmine Money - 支持多种货币类型的金额处理扩展包 1.0.13(3mo ago)0441MITPHPPHP ^8.2 Since Jan 20Pushed 3mo agoCompare [ Source](https://github.com/red-jasmine/money)[ Packagist](https://packagist.org/packages/red-jasmine/money)[ Docs](https://github.com/red-jasmine/money)[ RSS](/packages/red-jasmine-money/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (3)Versions (15)Used By (1) Red Jasmine Money ================= [](#red-jasmine-money) Red Jasmine Money 是一个基于 `moneyphp/money` 的 Laravel 金额处理扩展包，支持多种货币类型，包括 ISO 标准货币、比特币以及自定义虚拟货币。 特性 -- [](#特性) - ✅ 支持 ISO 标准货币 - ✅ 支持比特币货币 - ✅ 支持自定义虚拟货币（积分、游戏币、代金券等） - ✅ Eloquent Model 金额转换 - ✅ Spatie Laravel Data 集成 - ✅ 支持 decimal 和 bigint 两种存储类型 - ✅ 共享货币字段支持 - ✅ 完善的异常处理 安装 -- [](#安装) ``` composer require red-jasmine/money ``` 配置 -- [](#配置) 发布配置文件： ``` php artisan vendor:publish --tag=money-config ``` 配置文件 `config/money.php`： ``` return [ // 默认货币 'default_currency' => env('MONEY_DEFAULT_CURRENCY', 'CNY'), // 货币配置 'currencies' => [ // ISO 标准货币 'iso' => [ 'CNY', 'USD', 'EUR', 'GBP', 'JPY', 'HKD', 'TWD', 'KRW' ], // 或使用 'all' 支持所有 ISO 货币 // 'iso' => 'all', // 比特币货币 'bitcoin' => false, // 自定义货币 'custom' => [ // 积分 'POINTS' => [ 'name' => '积分', 'code' => 'POINTS', 'subunit' => 0, // 没有小数 'numeric_code' => 999, ], // 游戏金币 'GOLD' => [ 'name' => '金币', 'code' => 'GOLD', 'subunit' => 0, 'numeric_code' => 998, ], // 平台代金券 'VOUCHER' => [ 'name' => '代金券', 'code' => 'VOUCHER', 'subunit' => 2, // 两位小数 'numeric_code' => 997, ], ], ], ]; ``` 使用方法 ---- [](#使用方法) ### 1. Eloquent Model 中使用 [](#1-eloquent-model-中使用) #### 数据库迁移 [](#数据库迁移) ``` Schema::create('products', function (Blueprint $table) { $table->id(); $table->decimal('price_amount', 10, 2); // 金额 $table->string('price_currency', 3); // 货币代码 $table->timestamps(); }); ``` #### Model 定义 [](#model-定义) ``` use Illuminate\Database\Eloquent\Model; use Money\Money; use RedJasmine\Money\Casts\MoneyCast; class Product extends Model { protected $casts = [ 'price' => MoneyCast::class, ]; } ``` #### 使用示例 [](#使用示例) ``` // 创建产品 $product = new Product(); $product->price = new Money(10050, new Currency('CNY')); // 100.50 元 $product->save(); // 或使用字符串 $product->price = '100.50'; $product->save(); // 或使用数组 $product->price = [ 'amount' => '100.50', 'currency' => 'USD' ]; $product->save(); // 读取 $price = $product->price; // Money 对象 echo $price->getAmount(); // "10050" (最小单位：分) echo $price->getCurrency()->getCode(); // "CNY" ``` ### 2. Spatie Laravel Data 中使用 [](#2-spatie-laravel-data-中使用) ``` use Money\Money; use RedJasmine\Money\Casts\MoneyCast; use Spatie\LaravelData\Attributes\WithCast; use Spatie\LaravelData\Data; class ProductData extends Data { public function __construct( public string $name, #[WithCast(MoneyCast::class)] public ?Money $price = null, ) { } } ``` ### 3. 高级配置 [](#3-高级配置) #### 自定义字段名 [](#自定义字段名) ``` protected $casts = [ 'price' => MoneyCast::class . ':currency_code,money_value', ]; ``` 这将使用 `price_currency_code` 和 `price_money_value` 作为数据库字段。 #### 使用 bigint 类型存储 [](#使用-bigint-类型存储) ``` protected $casts = [ 'price' => MoneyCast::class . ':null,null,null,bigint', ]; ``` 数据库迁移： ``` $table->bigInteger('price_amount'); // 使用 bigint 存储最小单位 $table->string('price_currency', 3); ``` #### 共享货币字段 [](#共享货币字段) 当多个金额字段使用同一个货币时： ``` protected $casts = [ 'price' => MoneyCast::class . ':currency,null,true', 'cost' => MoneyCast::class . ':currency,null,true', ]; ``` 数据库迁移： ``` $table->decimal('price_amount', 10, 2); $table->decimal('cost_amount', 10, 2); $table->string('currency', 3); // 共享货币字段 ``` ### 4. 使用自定义货币 [](#4-使用自定义货币) ``` use Money\Currency; use Money\Money; // 使用积分 $points = new Money(1000, new Currency('POINTS')); // 使用游戏金币 $gold = new Money(500, new Currency('GOLD')); // 使用代金券 $voucher = new Money(5000, new Currency('VOUCHER')); // 50.00 ``` ### 5. 货币管理器 [](#5-货币管理器) ``` use RedJasmine\Money\Currencies\AggregateCurrencies; // 获取货币管理器 $currencies = app(AggregateCurrencies::class); // 检查货币是否支持 $isSupported = $currencies->contains(new Currency('POINTS')); // 获取货币小数位数 $subunit = $currencies->subunitFor(new Currency('CNY')); // 2 // 检查货币类型 $isISO = $currencies->isISO(new Currency('USD')); // true $isBitcoin = $currencies->isBitcoin(new Currency('XBT')); // true $isCustom = $currencies->isCustom(new Currency('POINTS')); // true ``` 参数说明 ---- [](#参数说明) `MoneyCast` 构造函数参数： ``` MoneyCast::class . ':currencyKey,valueKey,isShareCurrencyField,valueType' ``` - `currencyKey`: 货币字段名（默认：`{field}_currency`） - `valueKey`: 金额字段名（默认：`{field}_amount`） - `isShareCurrencyField`: 是否共享货币字段（默认：`false`） - `valueType`: 金额存储类型（`decimal` 或 `bigint`，默认：`decimal`） 许可证 --- [](#许可证) MIT License 贡献 -- [](#贡献) 欢迎提交 Issue 和 Pull Request！ ### Health Score 41 — FairBetter than 88% of packages Maintenance86 Actively maintained with recent releases Popularity8 Limited adoption so far Community8 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 13 Last Release 109d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/aaaa10537dd96827181cb5ff0c4df6078f48054457d9ebaebe0b230829482843?d=identicon)[liushoukun](/maintainers/liushoukun) --- Top Contributors [![liushoukun](https://avatars.githubusercontent.com/u/26298472?v=4)](https://github.com/liushoukun "liushoukun (2 commits)") --- Tags laravelmoneycurrencyred-jasmine ### Embed Badge ![Health badge](/badges/red-jasmine-money/health.svg) ``` [![Health](https://phpackages.com/badges/red-jasmine-money/health.svg)](https://phpackages.com/packages/red-jasmine-money) ``` ### Alternatives [cknow/laravel-money Laravel Money 1.0k4.3M22](/packages/cknow-laravel-money)[akaunting/laravel-money Currency formatting and conversion package for Laravel 7825.3M18](/packages/akaunting-laravel-money)[torann/currency This provides Laravel with currency functions such as currency formatting and conversion using up-to-date exchange rates. 4081.1M6](/packages/torann-currency)[andriichuk/laracash PHP Laravel Money Package 74108.2k1](/packages/andriichuk-laracash)[casinelli/currency Handles currency for Laravel 5. 1911.8k](/packages/casinelli-currency)[wujunze/money-wrapper MoneyPHP Wrapper 113.8k](/packages/wujunze-money-wrapper) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)