README.md

Unit Converter

Convert all kinds of standard units of measurement from one to another with this highly customizable, easy to use, lightweight PHP component.

Table of Contents:

1. About the Component
2. Installing the Component
3. Basic Usage

1. About the Component

This unit converter component aims to be modern and follow best practices. It also aims to be fully SI compliant (eventually...).

It supports the following types of measurement by default (support for more measurement types are on the roadmap).

• Area
• Data Transfer Rates Coming Soon!
• Digital Storage Coming Soon!
• Energy (Power)
• Frequency New!
• Fuel Economy New!
• Length
• Mass (Weight)
• Plane Angle (Rotation)
• Pressure
• Speed
• Temperature
• Time
• Volume

You also have the ability to override & customize the default units, as well as add your own!

2. Installing the Component

The best way to install the component is with Composer. For other supported methods, see the wiki artile on installation.

$ composer require jordanbrauer/unit-converter

3. Basic Usage

Using the component is very easy, especially if you have used the Symfony or Laravel frameworks before.

Quick-Start

If you'd like to skip the minutiae of this component's setup and get right down to business, you can get started by constructing a pre-configured converter via the builder object, like so,

use UnitConverter\UnitConverter;

$converter = UnitConverter::createBuilder()
    ->addSimpleCalculator()
    ->addDefaultRegistry()
    ->build();

and use it like this,

$converter->convert(1)->from("in")->to("cm"); # (float) 2.54

and you're done! For a more in-depth setup guide, check the wiki.

User Documentation

Setup guides, in-depth examples, tutorials, and explanations on the component for users who are looking to integrate it into their project, as-is.

User Documentation

API Documentation

If you are looking to extend and hack on this component for your own project, these pages will give you insight into all about how the component works, through the awesome power of dockblocks!

API Documentation