TYPO3中解析BINARY(16)存储的IPv6地址及确定对应类型

1. 确定$ipv6address的类型 #

在PHP及TYPO3生态中，最通用且兼容性最好的IPv6地址表示类型是**?string**（可空字符串），对应标准IPv6格式的字符串（如2001:db8::1）。如果需要更严格的类型约束，PHP 8.1+可启用\IpAddr\Ipv6原生类型，但需要确保环境支持该扩展，因此优先推荐可空字符串类型。

2. 解析二进制IPv6地址 #

数据库存储的BINARY(16)是网络字节序的二进制数据，可直接使用PHP原生函数inet_ntop()将其转换为标准IPv6字符串。需注意处理字段为null的场景。

修改后的完整代码 #

namespace Homeinfo\hwdb\Domain\Model;

use DateTime;

final class System
{
    function __construct(
        public readonly int $id,
        public readonly ?int $group,
        public readonly ?int $deployment,
        public readonly ?int $dataset,
        public readonly ?int $openvpn,
        public readonly ?string $ipv6address,
        public readonly ?string $pubkey,
        public readonly DateTime $created,
        public readonly ?DateTime $configured,
        public readonly bool $fitted,
        public readonly string $operating_system,
        public readonly ?bool $monitor,
        public readonly ?string $serial_number,
        public readonly ?string $model,
        public readonly ?DateTime $last_sync,
        public readonly bool $updating,
    )
    {
    }

    public static function fromArray(array $array): Self
    {
        $parsedIpv6 = $array['ipv6address'] !== null ? inet_ntop($array['ipv6address']) : null;

        return new self(
            $array['id'],
            $array['group'],
            $array['deployment'],
            $array['dataset'],
            $array['openvpn'],
            $parsedIpv6,
            $array['pubkey'],
            new DateTime($array['created']),
            (($configured = $array['configured']) === null) ? null : new DateTime($configured),
            $array['fitted'],
            $array['operating_system'],
            $array['monitor'],
            $array['serial_number'],
            $array['model'],
            (($last_sync = $array['last_sync']) === null) ? null : new DateTime($last_sync),
            $array['updating'],
        );
    }
}

补充说明 #

• 若需对IPv6地址做合法性验证，可使用TYPO3内置的TYPO3\CMS\Core\Utility\IpUtility::isValidIp6()方法。
• 如果项目使用Doctrine ORM与TYPO3深度集成，可自定义Doctrine类型实现二进制IPv6与字符串的自动转换，无需在fromArray中手动处理，但当前场景下原生inet_ntop()已足够高效简洁。

内容的提问来源于stack exchange，提问作者user3515670