跳到内容

Bic

编辑此页

此约束用于确保值具有 企业标识符代码 (BIC) 的正确格式。BIC 是一种国际公认的唯一标识金融和非金融机构的方式。您还可以检查 BIC 的国家代码是否与给定的 IBAN 的国家代码相同。

适用于 属性或方法
Bic
验证器 BicValidator

基本用法

要使用 Bic 验证器,请将其应用于将包含企业标识符代码 (BIC) 的对象的属性。

1
2
3
4
5
6
7
8
9
10
// src/Entity/Transaction.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Transaction
{
    #[Assert\Bic]
    protected string $businessIdentifierCode;
}

注意

与大多数其他约束一样,null 和空字符串被认为是有效值。这是为了允许它们成为可选值。如果该值是强制性的,一个常见的解决方案是将此约束与 NotBlank 结合使用。

可用选项

groups

类型array | string 默认值null

它定义了此约束的验证组。阅读更多关于 验证组 的信息。

iban

类型string 默认值null

用于验证其国家代码是否与 BIC 国家代码相同的 IBAN 值。

ibanMessage

类型string 默认值此企业标识符代码 (BIC) 未与 IBAN {{ iban }} 关联。

当值未通过 BIC/IBAN 组合检查时提供的默认消息。

ibanPropertyPath

类型string 默认值null

它定义了对象属性,该属性的值存储用于检查 BIC 的 IBAN。

例如,如果您想将某个对象的 $bic 属性与同一对象的 $iban 属性进行比较,请在 $bic 的比较约束中使用 ibanPropertyPath="iban"

message

类型string 默认值这不是有效的企业标识符代码 (BIC)。

当值未通过 BIC 检查时提供的默认消息。

您可以在此消息中使用以下参数

参数 描述
{{ value }} 当前的(无效的)BIC 值

payload

类型mixed 默认值null

此选项可用于将任意特定于域的数据附加到约束。配置的 payload 不会被 Validator 组件使用,但其处理完全取决于您。

例如,您可能想使用 多个错误级别,以便根据错误的严重程度在前端以不同的方式呈现失败的约束。

mode

类型string 默认值Bic::VALIDATION_MODE_STRICT

此选项定义了如何验证 BIC。可能的值在 Bic 类中以常量的形式提供

  • Bic::VALIDATION_MODE_STRICT 验证给定的值,不进行任何修改;
  • Bic::VALIDATION_MODE_CASE_INSENSITIVE 在验证之前将给定的值转换为大写。

7.2

mode 选项在 Symfony 7.2 中引入。

本作品,包括代码示例,根据 Creative Commons BY-SA 3.0 许可获得许可。
目录
    版本