fynduck/isin

一个用于生成和验证ISIN(国际证券识别号码/ISO 6166)的Laravel包

安装: 31

依赖: 0

建议者: 0

安全: 0

星标: 0

关注者: 0

分支: 2

开放问题: 0

类型:

v1.0.2.1 2020-01-13 15:03 UTC

This package is auto-updated.

Last update: 2024-09-14 19:53:23 UTC


README

Software License Latest Version on Packagist Total Downloads

一个用于生成和验证ISIN(国际证券识别号码/ISO 6166)的Laravel包。

ISIN将根据[https://en.wikipedia.org/wiki/International_Securities_Identification_Number]中详细说明的校验和进行检查

安装

该库可以通过composer安装

composer require fynduck/isin

使用方法

您可以通过传递一个字符串来实例化一个ISIN对象

use fynduck\Isin;

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

如果传入的值不是一个有效的ISIN,它将抛出fynduck\Isin\Exception\InvalidISINException。要获取回值,您可以这样做

$isin->getValue();
return GB00B3W23161

如果您只想获取校验位,可以使用

$isin->getCheckDigit();
return 1

生成ISIN

Isin::generateDigit('GB00B3W2316');
return: 1

验证ISIN

有一些辅助静态函数用于简单的验证。

Isin::isValid('GB00B3W23161');
return true

如果值是有效的ISIN,则返回true,否则返回false。

Isin::validate('gb00b3w23161');
return GB00B3W23161
$number = Isin::validate('ABC');
return InvalidISINException

这将返回正确格式的ISIN(去除空白并转换为大写)。如果输入无效,它将抛出fynduck\Isin\Exception\InvalidISINException

开发

此项目是开源的。欢迎反馈和pull请求。要开发代码

检出项目。运行composer install

运行测试

PHPUnit

vendor/bin/phpunit

代码检查器

vendor/bin/phpcs

在代码可以提交之前,两者必须运行成功。代码覆盖率也必须是100%。