malahierba-lab / chile-rut
用于管理和验证智利RUT的Laravel库
Requires
- php: >=5.5.18
- laravel/framework: >=5.0.0
README
简介
这个库允许处理智利用于个人和法人实体的识别号码,可以执行验证和格式化任务。
这个库是为 Laravel 设计的。
关于范围的解释
该库仅验证识别号码是否符合使用的算法,不检查该RUT的真实存在性。
安装
要安装这个库,只需将其添加到项目composer.json中的 require 部分,然后执行 composer update
对于Laravel 5.x或更高版本
"malahierba-lab/chile-rut": "5.1.*"
对于Laravel 4.2
"malahierba-lab/chile-rut": "4.2.*"
重要:如果你目前使用的是"dev-master"版本,你必须将其更改为根据你使用的Laravel版本指定的版本。
然后,在app/config/app.php文件中的 'providers' 数组中加载Service Provider。
对于Laravel 5.x
Malahierba\ChileRut\ChileRutServiceProvider::class
对于Laravel 4.2
'Malahierba\ChileRut\ChileRutServiceProvider'
可选(但强烈推荐)你可以在app/config/app.php文件中的 'aliases' 数组中创建一个别名,以便可以直接调用功能。
对于Laravel 5.x
'RUT' => Malahierba\ChileRut\Facades\ChileRut::class
对于Laravel 4.2
'RUT' => 'Malahierba\ChileRut\Facades\ChileRut'
如果你不想使用Facade,而是使用类本身,不要忘记将其包含在你想要使用的类中
use Malahierba\ChileRut\ChileRut;
使用方法
验证RUT
要验证智利RUT,只需使用:RUT::check($rut_a_validar)。例如:
if (RUT::check('12.345.678-9'))
echo 'es verdadero';
else
echo 'es falso';
请记住,如果不使用Facade,你必须使用类本身
$chilerut = new ChileRut; //o \Malahierba\ChileRut\ChileRut en caso de que no hayas importado la clase
if ($chilerut::check('12.345.678-9'))
echo 'es verdadero';
else
echo 'es falso';
在Laravel中验证RUT
使用自定义验证规则验证请求的示例
use Malahierba\ChileRut\ChileRut;
use Malahierba\ChileRut\Rules\ValidChileanRut;
$request->validate([
'rut' => ['required', 'string', new ValidChileanRut(new ChileRut)],
]);
计算校验位
如果我们有一个没有校验位的RUT,并且需要计算它,我们可以使用:RUT::digitoVerificador($rut)。例如:
$digitoVerificador = RUT::digitoVerificador($rut);
注意:考虑到校验位可能是'K'的情况,我们决定这个函数总是返回一个字符串,以确保使用的一致性和更严格的比较。
支持的RUT格式
如果我们有一个RUT格式为:x.xxx.xxx-x,以下格式可以用来处理它
- x.xxx.xxx-x(带有千位分隔符和连字符)
- xxxxxxx-x(不带千位分隔符和连字符)
- xxxxxxx(不带千位分隔符和连字符)
注意:无论哪种格式,都可以以零开头。例如:0x.xxx.xxx-x是支持的。
许可证
这个库以MIT许可证分发,请阅读LICENSE文件以获取更多信息。