MacAddress

編輯此頁

7.1

MacAddress 約束條件在 Symfony 7.1 中引入。

此約束條件確保給定的值是有效的 MAC 位址 (內部使用 FILTER_VALIDATE_MAC 選項，來自 filter_var PHP 函數)。

適用於	屬性或方法
類別	MacAddress
驗證器	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="https://symfony.dev.org.tw/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://symfony.dev.org.tw/schema/dic/constraint-mapping https://symfony.dev.org.tw/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 結合使用。

選項

`群組 (groups)`

類型: array | string 預設值: null

它定義此約束條件的驗證群組。閱讀更多關於驗證群組的資訊。

`訊息 (message)`

類型: string 預設值: 此值不是有效的 MAC 位址。

這是當值不是有效的 MAC 位址時將顯示的訊息。

您可以在此訊息中使用以下參數

參數	描述
`{{ value }}`	目前 (無效) 的值

`正規化器 (normalizer)`

類型: 一個 PHP 可呼叫 預設值: null

此選項允許定義在檢查給定值是否有效之前，應用於該值的 PHP 可呼叫物件。

例如，您可能希望傳遞 'trim' 字串以應用 trim PHP 函數，以便在驗證期間忽略開頭和結尾的空白。

`酬載 (payload)`

類型: mixed 預設值: null

此選項可用於將任意特定領域的資料附加到約束條件。 Validator 組件不使用已設定的酬載，但其處理完全取決於您。

例如，您可能想要使用多個錯誤層級，以便根據錯誤的嚴重性在前端以不同方式呈現失敗的約束條件。

`類型 (type)`

類型: string 預設值: all

7.1

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 授權條款授權。

版本