README

添加了轻松存储和处理多单位数据的能力

安装

composer require maksimru/multi-unit-models

表结构

您需要在模型中添加一个额外的文本列，后缀为 "_ucd"（可以在模型中自定义），以保存转换数据并能够在保证数据持久性的情况下切换值

Schema::create('vehicles', function (Blueprint $table) {
    $table->increments('vehicle_id');
    $table->double('height')->nullable();
    $table->text('height_ucd');
    $table->double('fuel_consumption_city')->nullable();
    $table->text('fuel_consumption_city_ucd');
    $table->timestamps();
});

模型集成

将 MaksimM\MultiUnitModels\Traits\MultiUnitSupport 添加到您的模型中

namespace MaksimM\MultiUnitModels\Tests\Models;

use Illuminate\Database\Eloquent\Model;
use MaksimM\MultiUnitModels\Traits\MultiUnitSupport;
use UnitConverter\Unit\FuelEconomy\KilometrePerLitre;
use UnitConverter\Unit\FuelEconomy\LitrePer100Kilometres;
use UnitConverter\Unit\FuelEconomy\MilesPerGallon;
use UnitConverter\Unit\Length\Kilometre;
use UnitConverter\Unit\Length\Mile;

class Vehicle extends Model
{

    use MultiUnitSupport;

    public $incrementing = true;
    protected $primaryKey = 'vehicle_id';
    protected $table = 'vehicles';

    public function getMultiUnitColumns()
    {
        return [
            //column name
            'height' => [
                //default unit (value will be stored in DB in specified default units)
                'default_unit' => Kilometre::class,
                //additional units that you want to have in your application
                'supported_units' => [
                    Kilometre::class,
                    Mile::class,
                ]
            ],
            'fuel_consumption_city' => [
                'default_unit' => LitrePer100Kilometres::class,
                'supported_units' => [
                    LitrePer100Kilometres::class,
                    KilometrePerLitre::class,
                    MilesPerGallon::class,
                ]
            ],
        ];
    }

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = [
        'name',
        'height',
        'fuel_consumption_city',
    ];

}

功能

模型创建和更新

$model = Vehicle::create([
    'name' => 'test',
    'fuel_consumption_city' => '5'
]);
// fuel_consumption_city is set to 5 L/100Km

$model = Vehicle::selectedUnits([
    'fuel_consumption_city' => 'mpg'
])->create([
    'name' => 'test',
    'fuel_consumption_city' => '5',
]);
// fuel_consumption_city is set to 5 mpg and DB will have fuel_consumption_city 47.04 (default units L/100Km), $model->fuel_consumption_city will return 5 (MPG)

$model->update([
    'fuel_consumption_city' => '1',
]);
// fuel_consumption_city is set to 1 mpg and DB will have fuel_consumption_city 235.215 (default units L/100Km), $model->fuel_consumption_city will return 1 (MPG)

$model->setMultiUnitFieldSelectedUnit('fuel_consumption_city', 'L/100km');
$model->update([
    'fuel_consumption_city' => '1',
]);
// fuel_consumption_city is set to 1 L/100Km

输入单位验证

您可以使用 supported_units 验证规则，以模型类作为参数

$validation = Validator::make([
    'fuel_consumption_city_units' => 'mpg'
], [
    'fuel_consumption_city_units' => 'supported_units:'.Vehicle::class.',fuel_consumption_city'
]);
//validation pass

辅助函数

$model->getMultiUnitFieldSupportedUnits('height')
//return supported units

$model->getMultiUnitFieldDefaultUnit('height')->getId()
//return default unit as string: km

$model->getMultiUnitFieldValue('height',(new Mile()))
//return specific field in specified unit

$model->getMultiUnitFieldValueByUnitName('height','mi')
//return specific field in specified unit

$model->setMultiUnitFieldSelectedUnit('height', 'mi');
//switch input and output units in real-time