devlabs/chileanrut

处理 Chilean Rut 的脚本

v1.5.0 2023-02-13 21:00 UTC

This package is auto-updated.

Last update: 2024-09-14 00:42:19 UTC


README

Latest Version on Packagist Total Downloads

处理 Chilean Rut 的脚本。查看 contributing.md 了解待办事项列表。

安装

通过 Composer

$ composer require devlabs/chileanrut

使用方法

格式化函数

根据指定的参数格式化 rut,如果 withDotted 为 true,则始终返回带有连字符的字符串值

Rut::format('123123123'); // return 12.312.312-3
Rut::format('123123123', false); // return 12312312-3
Rut::format('123123123', false, false); // return 123123123 (it is best to use the unformat function)

取消格式化函数

清除 rut 中的空格、点和连字符,返回字符串值

Rut::unformat('12.312.312-3'); // return 123123123

验证函数

检查代码是否通过验证算法有效,返回布尔值

Rut::validate('12.312.312-3'); // return true

计算校验位函数

根据顺序 rut 号码计算校验位,返回字符串值

Rut::calculateDv(12312312); // return 3

获取数字函数

提取 rut 的数字部分,可以根据参数返回带有点的字符串值,返回字符串值

Rut::getNumber('12312312-3'); // return 12312312
Rut::getNumber('12312312-3', true); // return 12.312.312

获取校验位函数

提取 rut 的校验位部分,返回字符串值

Rut::getDv('12312312-3'); // return 3

示例

namespace App\Http\Controllers;

use Devlabs\ChileanRut\Rut;

class RutController extends Controller
{
    public function index()
    {
        $format = Rut::format('123123123');
        $unformat = Rut::unformat($format);
        return [
            $format,
            $unformat,
            Rut::validate($unformat),
            Rut::calculateDv(12312312),
            Rut::getNumber($format, false),
            Rut::getDv($format),
        ];
    }
}

结果

[
  "12.312.312-3",
  "123123123",
  true,
  "3",
  "12312312",
  "3"
]

变更日志

请参阅 changelog 了解最近的变化。

测试

$ composer test

安全

如果您发现任何安全相关的问题,请通过电子邮件 aisla@devlabs.cl 而不是使用问题跟踪器。

致谢

许可

许可。请参阅 许可文件 了解更多信息。