PHPackages                             sourcepot/asset - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. sourcepot/asset

ActiveLibrary[Mail & Notifications](/categories/mail)

sourcepot/asset
===============

PHP class providing an asset object

v2.5.0(2mo ago)01082MITPHPPHP >=8.0

Since Jan 31Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/SourcePot/asset)[ Packagist](https://packagist.org/packages/sourcepot/asset)[ Docs](https://datapool.info)[ RSS](/packages/sourcepot-asset/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (4)Versions (35)Used By (2)

Installation
============

[](#installation)

You can use Packagist to install the package on a web server or your lacal computer, e.g. *Command Prompt*, enter `composer create-project sourcepot/asset {add your target directory here}`.

The following code examples require the namespace to be set to `namespace SourcePot\Asset;`.

Features
--------

[](#features)

- Creation and manipulation of an Asset object representing a value, wealth, etc.
- Creation of a Rates object providing currency names and exchange rates
- Creation of a DateTimeParser object providing representing a date and time at a specified timezone, parsing timestamps or strings to DateTimeParser object
- Calculations make use of Money PHP (`moneyphp/money`) and BC Math

The Asset class
---------------

[](#the-asset-class)

The asset class of this package can be used to create objects representing an asset. The main properties of such an asset are "value", "unit" and "dateTime", e.g. 1 (value) Euro (unit) on 12/03/2023. These three properties need to be provided to the contructor of a new asset object. If a different unit is set, the exchange rate is applied to the asset object and the dateTime will be updated to the excchange rate dateTime.

Note

European Central Bank exhchage rates are used. If an exchage rate is not yet present as csv-file in the data directory, it will be downloaded via the ECB API and saved to data directory. If an exchange rate is requested for a weekend (such as in the code sample below) or bank holiday, the latest valid exchange rate before that date will be used and a warning will be added as asset property.

The Asset class

```
require_once('../php/Asset.php');

// asset object creation
$asset = new Asset(100000,'GBP',new \DateTime("2016-08-31T12:00:00+01:00"));

// setting a new unit, converting GBP to USD @2016-08-31
$asset->convert2unit('USD');

// will show 131264.20 USD (2016-08-31T12:00:00+01:00), the asset property dateTime was adjusted to the exchange rate dateTime
echo $asset;

```

Method `\SourcePot\Asset\Asset::getArray()` returns an array with derived asset properties including any warnings or errors.

```
$assetArr = $asset->getArray();

/*  The array content is:
object {11}
ISO 8601:           2015-08-21T23:00:00+01:00
RFC 2822:           Fri, 21 Aug 2015 23:00:00 +0100
Timestamp:          1440194400
Currency:           USD
Amount:             10.06
Amount de:          10,06
Amount (US):        USD 10.06
Amount (DE):        10,06 USD
Amount (DE full):   10,06 USD
Amount (FR):        10.06 USD
Warning:            W001: "USD" rate for "2015-08-22" missing, rate dated "2015-08-21" used.
*/

```

An asset can be added to the asset object using the method `\SourcePot\Asset\Asset::addAsset(float $value=0,string $unit=self::DEFAULT_UNIT,\DateTime $dateTime=NULL)` and providing the respective asset properties. In the following example the asset is *100 EUR (2024-01-01T00:00:00+01:00)* and an amount of 100 GBP is added on December 01, 2024:

```
$asset->addAssetString('1000000 JPY');

// The new asset is 107373.00 GBP (2016-08-31T12:00:00+01:00), the date is set to the exchange rate date
echo $asset;

```

Method `\SourcePot\Asset\Asset::setFromString(string $string,string $unit=self::DEFAULT_UNIT,\DateTime $dateTime=NULL)` provides a string parser. The method loads the asset derived from the string to the asset object. If the currency can't be derived, the default is used and if dateTime is not provided, `DateTime('now')` will be used.

```
$asset->setFromString('AU$ 12.345,67');

// The new asset is 12345.67 AUD (2025-02-22T15:41:26+01:00)
echo $asset;

```

The Rates class
---------------

[](#the-rates-class)

The Rates class supports the Asset class with unit conversion. Currencies are subset of units. The following code example creates a Rates object and retunrs available currencies.

```
namespace SourcePot\Asset;

require_once('../php/Rates.php');

$ratesObj=new Rates();
$rates=$ratesObj->getCurrencies();

var_dump($rates);

```

The DateTimeParser class
------------------------

[](#the-datetimeparser-class)

The DateTimeParser class provides methods for creating/updating a DateTime object from timestamps or strings. The following example creates a DateTimeParser object, sets a new state by parsing a string and outputs the DateTimeParser object. Since the setFromString() method is called without the timezone argument, the default timezone is used. The time zone is therefore changed from Asia/Tokyo to Europe/Berlin. The setFromString() method supports very different date/time formats. A timezone is only recognized in the string if the spelling corresponds exactly to a php time zone.

```
require_once('../php/DateTimeParser.php');

$dateTimeParserObj=new DateTimeParser();
$dateTimeParserObj->setFromString('Meeting on August 2., 2014 at 12:34:56 (Asia/Tokyo)');

// the uptated DateTimeParser object returns 2014-08-02T05:34:56+02:00
echo $dateTimeParserObj;

```

// the default timezone is Europe/Berlin, the parsed sting will return 2014-08-02T05:34:56+02:00 echo $asset;

Evaluation web page
===================

[](#evaluation-web-page)

An evaluation web page is provided with this package.

The webpage allows:

1. flexible creation of an asset object,
2. asset conversion to US-Dollars and
3. adding yearly interest.

Here is a screenshot of the evaluation web page: [![Evaluation web page](./assets/evaluation-page.png)](./assets/evaluation-page.png)

###  Health Score

43

—

FairBetter than 90% of packages

Maintenance86

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~13 days

Recently: every ~35 days

Total

34

Last Release

72d ago

Major Versions

v0.0.5 → v1.0.02025-02-01

v1.3.4 → v2.0.02025-02-22

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/115737488?v=4)[Carsten Wallenhauer](/maintainers/SourcePot)[@SourcePot](https://github.com/SourcePot)

---

Top Contributors

[![SourcePot](https://avatars.githubusercontent.com/u/115737488?v=4)](https://github.com/SourcePot "SourcePot (84 commits)")

---

Tags

calculationecb-ratesmoneywealthemail

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sourcepot-asset/health.svg)

```
[![Health](https://phpackages.com/badges/sourcepot-asset/health.svg)](https://phpackages.com/packages/sourcepot-asset)
```

###  Alternatives

[egulias/email-validator

A library for validating emails against several RFCs

11.6k719.7M402](/packages/egulias-email-validator)[sendgrid/sendgrid

This library allows you to quickly and easily send emails through Twilio SendGrid using PHP.

1.5k49.8M183](/packages/sendgrid-sendgrid)[pelago/emogrifier

Converts CSS styles into inline style attributes in your HTML code

94745.9M132](/packages/pelago-emogrifier)[zbateson/mail-mime-parser

MIME email message parser

54551.9M86](/packages/zbateson-mail-mime-parser)[soundasleep/html2text

A PHP script to convert HTML into a plain text format

48520.6M85](/packages/soundasleep-html2text)[opcodesio/mail-parser

Parse emails without the mailparse extension

228.1M9](/packages/opcodesio-mail-parser)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)