juststeveking/gtin-php

用于验证 GTIN 码的 PHP 包

v1.0.1 2021-01-13 14:26 UTC

This package is auto-updated.

Last update: 2024-09-11 21:18:54 UTC


README

Software License PHP Version Latest Version on Packagist Tests Scrutinizer Code Quality Total Downloads

用于在纯 PHP 和 Laravel 中验证 GTIN 码的 PHP 包。

安装

您可以通过 composer 安装此包

composer require juststeveking/gtin-php

PHP 使用

如果您使用的是 Laravel 以外的框架,或者直接使用 Laravel,您可以直接使用 Gtin 类来验证传入的值的部分或全部。您可以查看gtin 和 GS1 的规范

验证正确长度

GTIN 长度在 8 到 14 个字符之间。

use JustSteveKing\GtinPHP\Gtin;

$correct = 614141999996;
$valid = Gtin::length($correct); // returns true

$incorrect = 123456;
$failed = Gtin::length($incorrect); // returns false

验证其为整数

GTIN 必须是整数值,在 PHP 中您可以使用 is_int() 很容易地做到这一点,但我这里提供了一个方法来做同样的事情

use JustSteveKing\GtinPHP\Gtin;

$correct = 614141999996;
$valid = Gtin::integer($correct); // returns true

$incorrect = '614141999996';
$failed = Gtin::integer($incorrect); // returns false

检查 gtin 并验证校验位

GTIN 以非常特定的方式格式化,这已在具体规范文档中完全说明。

use JustSteveKing\GtinPHP\Gtin;

$correct = 614141999996;
$valid = Gtin::inspect($correct); // returns true

$incorrect = 123456789;
$failed = Gtin::inspect($incorrect); // returns false

一次性验证所有方面

use JustSteveKing\GtinPHP\Gtin;

$correct = 614141999996;
$valid = Gtin::validate($correct); // returns true

$incorrect = 123456789;
$failed = Gtin::validate($incorrect); // returns false

Laravel 中的验证

此包还注册了 Laravel 规则和验证宏,请使用以下任一方式使用

// using the class directly
public function rules()
{
    return [
        'gtin' => [
            'required',
            new JustSteveKing\GtinPHP\Rules\Gtin,
        ]
    ];
}
// using the registered macro
public function rules()
{
    return [
        'gtin' => [
            'required',
            Rule::gtin(),
        ]
    ];
}

如果更方便,可以直接使用 Gtin 类。

测试

composer test

贡献

有关详细信息,请参阅CONTRIBUTING

安全漏洞

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

鸣谢

许可证

MIT 许可证 (MIT)。有关更多信息,请参阅许可证文件