README

A collection of unit conversions utils for Laravel

Convert units of measure in Laravel.

Installation

You can install the package via composer:

composer require sfolador/measures-for-laravel

You can publish the config file with:

php artisan vendor:publish --tag="measures-for-laravel-config"

Usage

use \Sfolador\Measures\Measures;
use  \Sfolador\Measures\Unit\Length\Length;
\Sfolador\Measures\Unit\Weight\Weight;

$measure = Measures::length("2.0m");
echo $measures->toCm(); // 200.0 cm

//or you can use the Length class directly

$length = Length::from("2.0m");
echo $length->toCm(); // 200.0 cm

$measure = Measures::weight("2.0Kg");
echo $measures->toG(); // 2000.0 g

//or you can use the Weight class directly

$length = Weight::from("2.0Kg");
echo $length->toG(); // 2000.0 g

It's possible to use also extended fluent methods:

$measure = Length::from("2.0m");
echo $measures->toCentimeters(); // 200 cm

//you can chain the methods: 

echo  Length::from("2.0m")->toCentimeters(); // 200 cm

If you do not know which kind of measure you are dealing with, you can use the Measures class to automatically detect the type of measure:

$measure = Measures::from("2.0m"); // $measure is an instance of Length
echo $measures->toCm(); // 200 cm

$measure = Measures::from("2.0Kg"); // $measure is an instance of Weight
echo $measures->toG(); // 2000 g

Eloquent cast

It's possible to cast a model attribute to a measure:

use \Sfolador\Measures\Unit\Weight\Weight;
use Sfolador\Measures\Cast\Measure;

class Product extends Model
{
    protected $casts = [
        'weight' => Measure::class,
        'length'   => Measure::class,
    ];
}

$product = Product::first();
echo $product->weight->toKg(); // 2 Kg
echo $product->length->toCm(); // 200 cm


$product->weight = Weight::from("3.0Kg");
$product->length = Length::from("1.0m");

$product->save();
echo $product->weight->toKg(); // 3 Kg
echo $product->length->toCm(); // 100 cm

Available units

Length

Millimeter
Centimeter
Meter
Kilometer
Inch
Foot
Yard
Mile
Nautical mile

Weight

Milligram
Gram
Kilogram
Ton
Ounce
Pound
Stone
Long ton
Short ton

Volume

Milliliter
Liter
Cubic meter
Cubic inch
Cubic foot
Gallon
Pint
Cup

Temperature

Celsius
Fahrenheit
Kelvin

Area

Square meter
Square kilometer
Square centimeter
Square millimeter
Square inch
Square foot
Square yard
Square mile
Acre
Hectare

Data

Bit
Byte
Kilobit
Kilobyte
Megabit
Megabyte
Gigabit
Gigabyte
Terabit
Terabyte
Petabit
Petabyte
kibibit
kibibyte
mebibit
mebibyte
gibibit
gibibyte
tebibit
tebibyte
pebibit
pebibyte

Speed

Meter per second
Kilometer per hour
Mile per hour
Knot
Foot per second
Mach

Time

Nanosecond
Microsecond
Millisecond
Second
Minute
Hour
Day
Week
Month
Year

Pressure

Pascal
Kilopascal
Bar
Millibar
Atmosphere
Torr
Pound per square inch
Millimeter of mercury

Energy

Joule
Kilojoule
Megajoule
Gigajoule
Watt hour
Kilowatt hour
Megawatt hour
Gigawatt hour
Calorie
Kilocalorie
Megacalorie
Gigacalorie
Electronvolt
Kiloelectronvolt
Megaelectronvolt
Gigaelectronvolt

Angle

Degree
Radian

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.

sfolador / measures-for-laravel

Maintainers

Details