如何配置JMS Serializer反序列化器支持PHP7.1可空类型？

没问题，完全可以实现！下面我给你两种实用的配置方案，既能让JMS Serializer识别PHP 7.1的原生可空类型，还能让标注@Type("string")的属性也接受空JSON或缺失字段的情况：

方案1：全局配置宽松反序列化规则 #

这是最省事的方法，直接修改JMS的全局配置，让所有非可空类型注解默认允许null值和缺失字段。

YAML配置（Symfony环境常用） #

在config/packages/jms_serializer.yaml里添加：

jms_serializer:
    deserialization:
        # 当JSON中缺少字段时，自动设为null而非抛出异常
        missing_field_behavior: null
        # 当输入类型与注解类型不匹配（比如给string类型传null），设为null而非报错
        null_on_invalid_type: true

PHP代码配置（独立使用Serializer时） #

如果是自己构建Serializer实例，这么写：

use JMS\Serializer\SerializerBuilder;
use JMS\Serializer\DeserializationContext;

$serializer = SerializerBuilder::create()
    ->setDeserializationContextFactory(function () {
        $context = new DeserializationContext();
        // 缺失字段时设为null
        $context->setMissingFieldBehavior(DeserializationContext::MISSING_FIELD_NULL);
        // 无效类型（比如null给string）时设为null
        $context->setNullOnInvalidType(true);
        return $context;
    })
    ->build();

配置完成后，你原来的Foo类：

class Foo {
    /** @Type("string") */
    private $test;

    // 记得添加上getter/setter，或者配置JMS允许直接访问私有属性
}

反序列化空JSON {} 时，$test会被自动设为null，不会再抛出异常。

方案2：自定义类型处理器（更灵活） #

如果不想全局修改规则，只想针对特定类型（比如string）做兼容，可以自定义一个类型处理器，让指定类型接受null值。

第一步：创建自定义处理器 #

use JMS\Serializer\Handler\SubscribingHandlerInterface;
use JMS\Serializer\GraphNavigatorInterface;
use JMS\Serializer\VisitorInterface;
use JMS\Serializer\Context;

class NullableStringHandler implements SubscribingHandlerInterface
{
    public static function getSubscribingMethods()
    {
        return [
            [
                'direction' => GraphNavigatorInterface::DIRECTION_DESERIALIZATION,
                'format' => 'json',
                'type' => 'string',
                'method' => 'deserializeNullableString',
            ],
        ];
    }

    public function deserializeNullableString(VisitorInterface $visitor, $data, array $type, Context $context)
    {
        // 输入为null时直接返回null
        if (null === $data) {
            return null;
        }
        // 否则用默认的字符串反序列化逻辑
        return $visitor->visitString($data, $type, $context);
    }
}

第二步：注册处理器到Serializer #

$serializer = SerializerBuilder::create()
    ->configureHandlers(function (\JMS\Serializer\Handler\HandlerRegistry $registry) {
        $registry->registerHandler(new NullableStringHandler());
    })
    // 别忘了搭配缺失字段的配置，否则字段缺失还是会报错
    ->setDeserializationContextFactory(function () {
        $context = new DeserializationContext();
        $context->setMissingFieldBehavior(DeserializationContext::MISSING_FIELD_NULL);
        return $context;
    })
    ->build();

这个方案只针对string类型生效，其他类型不受影响，适合需要精细化控制的场景。

额外提示 #

• 如果你已经用了PHP原生可空类型（比如private ?string $test;），JMS Serializer会自动识别，不需要额外配置，即使注解写@Type("string")也能接受null值。
• 全局配置会影响所有类和属性，如果只想针对特定类，可以在类注解里用@Context参数覆盖全局规则，比如@Context(missingFieldBehavior: "null")。

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