wdandrewjames/unit-converter

A simple unit converter library for PHP

1 2020-11-06 13:03 UTC

This package is auto-updated.

Last update: 2024-05-06 21:56:12 UTC


README

Unit Converter is a PHP library for dealing with converting units.

Installation

Use composer to install.

composer require wdandrewjames/unit-converter

Usage

Instantiate a new Converter Object, which requires an object which implements the ConverterTypeInterface. In this case we are using Mass class.

use Converter\Converter;
use Converter\ConversionTypes\Mass;

$converter = new Converter(new Mass);

Use the convert() method on the Converter object to set the value you wish to convert from. This method accepts 2 arguments:

$value: The value being converted from

$unit: The unit you being converted from

Once the convert() method has been run, you may then use the to() method. This method takes 1 argument:

$unit: The unit you being converted to

echo $converter->convert(1, 'kilogram')->to('gram');
// 1000

You can also run multiple conversions once convert() method has been run.

$converter->convert(1000, 'gram');

echo $converter->to('kilogram');
// 1
echo $converter->to('gram');
// 1000
echo $converter->to('pound');
// 2.2046244201838
echo $converter->to('milligram');
// 1000000

The getAvailableUnits() method will return an array of all available units for a particular conversion quantity.

use Converter\Converter;
use Converter\ConversionTypes\Mass;

$converter = new Converter(new Mass);
$converter->getAvailableUnits();

Available Conversion Types

Length

Mass

Speed

Volume

License

MIT