Mac地址

编辑此页

7.1

The MacAddress 约束在 Symfony 7.1 中引入。

此约束确保给定的值是一个有效的 MAC 地址（内部使用 PHP 函数 filter_var 的 FILTER_VALIDATE_MAC 选项）。

应用于	属性或方法
类	Mac地址
验证器	MacAddressValidator

基本用法

要使用 MacAddress 验证器，请将其应用于对象上可以包含 MAC 地址的属性

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

use Symfony\Component\Validator\Constraints as Assert;

class Device
{
    #[Assert\MacAddress]
    protected string $mac;
}
    

        1
2
3
4
5
        # config/validator/validation.yaml
App\Entity\Device:
    properties:
        mac:
            - MacAddress: ~
    

        1
2
3
4
5
6
7
8
9
10
11
12
        <!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.ac.cn/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.ac.cn/schema/dic/constraint-mapping http://symfony.ac.cn/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Entity\Device">
        <property name="max">
            <constraint name="MacAddress"/>
        </property>
    </class>
</constraint-mapping>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
        // src/Entity/Device.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Validator\Mapping\ClassMetadata;

class Device
{
    // ...

    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addPropertyConstraint('mac', new Assert\MacAddress());
    }
}
    

注意

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

选项

`分组`

类型: array | string 默认值: null

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

`消息`

类型: string 默认值: This value is not a valid MAC address. 此值不是有效的 MAC 地址。

如果值不是有效的 MAC 地址，将显示此消息。

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

参数	描述
`{{ value }}`	当前（无效）值

`标准化器`

类型: a PHP 可调用对象 默认值: null

此选项允许定义在检查给定值是否有效之前应用于该值的 PHP 可调用对象。

例如，您可能希望传递 'trim' 字符串以应用 trim PHP 函数，以便在验证期间忽略前导和尾随空格。

`载荷`

类型: mixed 默认值: null

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

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

`类型`

类型: string 默认值: all

7.1

The type 选项在 Symfony 7.1 中引入。

此选项定义允许的 MAC 地址类型。根据您的需要，有很多不同的可能值

参数	允许的 MAC 地址
`all`	全部
`all_no_broadcast`	除广播地址外的所有地址
`broadcast`	仅广播地址
`local_all`	仅本地地址
`local_multicast_no_broadcast`	仅本地和组播地址，除广播地址外
`local_multicast`	仅本地和组播地址
`local_no_broadcast`	仅本地地址，除广播地址外
`local_unicast`	仅本地和单播地址
`multicast_all`	仅组播地址
`multicast_no_broadcast`	仅组播地址，除广播地址外
`unicast_all`	仅单播地址
`universal_all`	仅通用地址
`universal_unicast`	仅通用和单播地址
`universal_multicast`	仅通用和组播地址

本作品，包括代码示例，根据 Creative Commons BY-SA 3.0 许可协议获得许可。

版本