README

Copper: An API extension for NumberFormatter.

Installation

Via Composer run the following:

$ composer require pwweb/copper

Usage

Commands

This package makes it easy to format numbers using PHP NumberFormatter. In essence it wraps things up in a simple to use API.

To get started you will need to create a new instance:

<?php
...
Copper\Copper::create(?float $value = null, ?int $style = null, ?string $locale = null);

i.e.:

<?php
...
$formatter = Copper\Copper::create(-1234.56, \NumberFormatter::DECIMAL, 'en-GB');

If you don't provide a $style it will default to NumberFormatter::DECIMAL. If you don't provide the $locale it will default to the value of the Laravel application.

Then with this you can format in any of the following ways:

Since the create() function returns an instance of Copper, you can chain the methods together i.e. Copper\Copper::create(-1234.56)->currency('EUR') leads to -€1,234.56.

This means that it's particularly helpful in Blade templates:

{{ Copper\Copper::create($order->value)->currency('USD') }}

In addition to the base functions there are a few setters and getters:

Change log

Please see the changelog for more information on what has changed recently.

Contributing

Please see contributing.md for details and a todolist.

Security

If you discover any security related issues, please email securtity@pw-websolutions.com instead of using the issue tracker.

pwweb / copper

Maintainers

Details