unifyunits / unifyunits-laravel

v0.1.0 2026-09-29 17:46 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^10.0 || ^11.0 || ^12.0 || ^13.0
• illuminate/http: ^10.0 || ^11.0 || ^12.0 || ^13.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• orchestra/testbench: ^8.0 || ^9.0 || ^10.0
• phpunit/phpunit: ^10.0 || ^11.0 || ^12.0

MIT

Published on Packagist.org on 2026-09-30 02:25 UTC

README

A small Laravel HTTP client for the UnifyUnits Measurement API. It sends values as decimal strings so PHP floating-point conversion does not alter precision.

Requirements

• PHP 8.2 or newer
• Laravel 10, 11, 12, or 13

Install

Until the package is published on Packagist, add the GitHub repository to your application's Composer configuration and install the v0.1 release:

composer config repositories.unifyunits-laravel vcs https://github.com/unifyunits/unifyunits-php
composer require unifyunits/unifyunits-laravel:^0.1

After Packagist publication, the repository configuration step will no longer be needed.

Laravel discovers the service provider automatically. Publish its configuration and set credentials in the application environment:

php artisan vendor:publish --tag=unifyunits-config

UNIFYUNITS_BASE_URL=https://api.unifyunits.com
UNIFYUNITS_API_KEY=uu_live_your_key
UNIFYUNITS_TIMEOUT=10

Keep API keys in server-side environment configuration. Do not expose them in browser code, source control, or logs.

Usage

Inject the client contract:

use UnifyUnits\Laravel\Contracts\UnifyUnitsClient;

class QuoteController
{
    public function __invoke(UnifyUnitsClient $units)
    {
        $conversion = $units->convert('1000', 'm', 'km');

        return $conversion['data']['result']; // ['value' => '1', 'unit' => 'km']
    }
}

Or use the facade:

use UnifyUnits\Laravel\Facades\UnifyUnits;

$result = UnifyUnits::convert('72', 'mi/h', 'km/h');

Available methods are convert, convertBatch, categories, category, units, unit, and health. Conversion values must be strings. Batch requests return each item's success or error plus aggregate counts; individual item errors do not make the entire batch response an HTTP failure.

HTTP failures throw UnifyUnits\Laravel\Exceptions\ApiException, which offers errorCode(), requestId(), and details() helpers. Network and timeout exceptions from Laravel's HTTP client remain distinguishable from API errors.

Local development and tests

composer install
composer test

Tests use Laravel's HTTP fake and contain no production credentials. They can be run on PHP 8.2 or newer with:

composer install
composer test
composer analyse

This package is released independently from the API. GitHub releases do not publish it to Packagist.