djmarland/isin

A PHP Library for storing a validating an ISIN (International Securities Identification Number / ISO 6166)

isin

A PHP Library for storing a validating an ISIN (International Securities Identification Number / ISO 6166). ISINs will be checked against the checksum as detailed at [https://en.wikipedia.org/wiki/International_Securities_Identification_Number], _(*1)

Installation

The library can be installed via composer, _(*2)

composer require djmarland/isin

Usage

You can instantiate an ISIN object by passing in a string, _(*3)

use Djmarland\ISIN;

$number = 'GB00B3W23161';
$isin = new ISIN($number);

If the value passed in was not a valid ISIN it will throw a Djmarland\ISIN\Exception\InvalidISINException To get the value back out you can do, _(*4)

$value = $isin->getValue();
// GB00B3W23161

If you want to get hold of just the check digit you can use, _(*5)

$digit = $isin->getCheckDigit();
// 1

The object has a __toString so usage in views/routes etc will work:, _(*6)

echo 'The ISIN is ' . $isin;
// The ISIN is GB00B3W23161

Validating ISINs

There are some helper static functions for simple validation., _(*7)

$valid = ISIN::isValid('GB00B3W23161');
// true

This will return true if the value was a valid ISIN, false otherwise., _(*8)

$number = ISIN::validate('gb00b3w23161');
// GB00B3W23161
$number = ISIN::validate('ABC');
// InvalidISINException

This will return the properly formatted ISIN (whitespace trimmed and converted to uppercase). It will throw a Djmarland\ISIN\Exception\InvalidISINException if the input was not valid., _(*9)

Development

This project is open source. Feedback and pull requests are welcome. To develop the code:, _(*10)

Checkout the project. Run composer install, _(*11)

Running Tests

PHPUnit, _(*12)

vendor/bin/phpunit

Code Sniffer, _(*13)

vendor/bin/phpcs

Both must be run successfully before code can be submitted. Code coverage must also be 100%., _(*14)