malahierba-lab/chile-rut

用于管理和验证智利RUT的Laravel库

5.1.4 2019-10-28 18:00 UTC

This package is auto-updated.

Last update: 2024-09-05 00:00:25 UTC


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)],
]);

参考:Laravel: Custom Validation Rules

计算校验位

如果我们有一个没有校验位的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文件以获取更多信息。