fynduck / isin
一个用于生成和验证ISIN(国际证券识别号码/ISO 6166)的Laravel包
v1.0.2.1
2020-01-13 15:03 UTC
Requires
- php: >=5.4
Requires (Dev)
- phpunit/phpunit: ^4.7|^5.0
- squizlabs/php_codesniffer: ^2.3
README
一个用于生成和验证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%。