laravel-amount

原作者:https://github.com/hao-li/laravel-amount

背景

系统中涉及到金额的字段，View 层表现的时候一般都是以元为单位使用小数形式展示，不过 Domain 层存储时从空间、性能、容错角度出发，经常以分为单位，用整型来存储。

在 Lavarel 中，可以在 Model 中添加属性方法进行转换

public function getAmountAttribute($value)
{
    return $value / 100;
}

public function setAmountAttribute($value)
{
    $this->attributes['amount'] = (int)($value * 100);
}

不过涉及金额的字段比较多时就需要定义很多相同逻辑的函数，本项目即将该逻辑抽出为 Trait，简化金额字段相关的处理。

原理

将转换逻辑封装在 AmountTrait 中，覆写 Model 类的 getMutatedAttributes, mutateAttributeForArray, getAttributeValue 及 setAttribute 方法，当访问相关字段时自动进行转换处理。

public static $amountTimes = 100;

public function getMutatedAttributes()
{
    $attributes = parent::getMutatedAttributes();
    return array_merge($attributes, $this->getAmountFields());
}

protected function mutateAttributeForArray($key, $value)
{
    return (in_array($key, $this->getAmountFields()))
        ? (function_exists('bcdiv') ? bcdiv($value, self::$amountTimes, 2) : $value / self::$amountTimes)
        : parent::mutateAttributeForArray($key, $value);
}

public function getAttributeValue($key)
{
    $value = parent::getAttributeValue($key);
    if(function_exists('bcdiv')){
        $value = bcdiv($value, self::$amountTimes,2);
    }else{
        $value = $value / self::$amountTimes;
    }

    return $value;
}

public function setAttribute($key, $value)
{
    if (in_array($key, $this->getAmountFields())) {
          if(function_exists('bcmul')){
              $value = (int)bcmul($value, self::$amountTimes);
          }else{
              $value = (int)($value * self::$amountTimes);
          }
    }
    parent::setAttribute($key, $value);
}

public function getAmountFields()
{
    return (property_exists($this, 'amountFields')) ? $this->amountFields : [];
}

依赖

Laravel >= 5.2

安装

composer require "youngkingoo6/laravel-amount:dev-master"

使用

1. 在 Model 中引用 AmountTrait

use Youngkingoo6\LaravelAmount\Traits\AmountTrait;

2. 使用 AmountTrait

use AmountTrait;

3. 定义金额字段（本例中为 amount）

protected $amountFields = ['amount'];

4. 完成

之后读取 amount 字段时，该字段的内容会自动从数据库的分转换为元，向其赋值时反之从元转换为分。

5. 中文大写

如需转换为中文金额大写，只需在模型上调用的字段后面加 '_cny' 即可返回大写金额。

$model->amount_cny;

如果不想定义 $amountFields 字段，也可以直接调用修改器

$model->cny;

FAQ

和别的 trait 中方法冲突

以 setRawAttributes 为例（此为之前方案，目前并未覆写此方法，仅为举例，其他方法原理相同）

1. 将冲突的方法分别重命名

use AmountTrait, BTrait {
    AmountTrait::setRawAttributes as amountTraitSetRawAttributes;
    BTrait::setRawAttributes as BTraitSetRawAttributes;
}

2. 在 Model 中定义该冲突的方法，根据情况分别调用别名方法

public function setRawAttributes(array $attributes, $sync = false)
{
    $this->BTraitSetRawAttributes($attributes, $sync);
    $attributes = $this->getAttributes();
    $this->amountTraitSetRawAttributes($attributes, $sync);
}

注意这里 $attributes 可能已被改变，所以再次使用时要重新取得最新值