Mykad 包是一个 Laravel 包,专门用于验证、解析和格式化马来西亚身份证(MyKad)号码。

资助包维护!
FikriMastor

v1.0.3 2024-05-22 03:50 UTC

README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

MyKad 是一个 Laravel 包,专门用于验证、解析、提取和格式化马来西亚身份证(MyKad)号码。

安装

您可以通过 composer 安装此包

composer require fikrimastor/mykad

可选地,您可以使用以下命令发布配置文件

php artisan vendor:publish --tag="mykad-config"

这是已发布配置文件的内容

return [
    'states-code' => [
        // Source: https://www.jpn.gov.my/my/kod-negeri

        // Johor
        '01' => 'Johor',
        '21' => 'Johor',
        '22' => 'Johor',
        '23' => 'Johor',
        '24' => 'Johor',

        // Kedah
        '02' => 'Kedah',
        '25' => 'Kedah',
        '26' => 'Kedah',
        '27' => 'Kedah',

        ...
        ...
        ...

        // Negeri Tidak Diketahui
        '82' => 'Unknown',
    ],
];

用法

use FikriMastor\MyKad\Facades\MyKad;

echo MyKad::sanitize('010101-01-0101'); // '010101010101'

echo MyKad::extract('010101010101'); 
//[
//  "date_of_birth" => "1 January 2001"
//  "state" => "Johor"
//  "gender" => "Male"
//]

您还可以使用验证器来验证 MyKad 号码。

use FikriMastor\MyKad\Rules\IsMyKad;
 
$request->validate([
    'mykad' => ['required', 'string', new IsMyKad],
]);

测试

composer test

变更日志

请参阅 CHANGELOG 了解最近的变化信息。

贡献

贡献使得开源社区成为一个学习、灵感和创作的绝佳地方。您做出的任何贡献都备受赞赏。

如果您有改进的建议,请fork 仓库并创建一个 pull request。您也可以简单地通过带有“enhancement”标签的问题来提出建议。别忘了给项目点个赞!再次感谢!

  1. fork 项目
  2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

安全漏洞

请查看 我们的安全策略 了解如何报告安全漏洞。

鸣谢

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 了解更多信息。