Extbase模型用户输入清洗：验证前如何处理输入？

针对你遇到的Extbase模型字段清洗问题，以下是几种标准且可行的解决方案，适配你的手机号清洗需求：

方案1：自定义属性转换器（推荐） #

Extbase的属性映射系统允许你为特定字段定义转换器，在原始请求值映射到模型属性前完成清洗。这是官方推荐的输入处理方式，能避免验证器中修改克隆对象无效的问题。

步骤： #

1. 创建自定义转换器类：

use TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface;
use TYPO3\CMS\Extbase\Property\TypeConverter\AbstractTypeConverter;

class TelephoneSanitizerConverter extends AbstractTypeConverter
{
    // 定义支持的目标类型（手机号以字符串存储）
    protected $targetType = 'string';
    // 设置优先级，确保比默认转换器先执行
    protected $priority = 10;

    /**
     * @param mixed $source 原始用户输入值
     * @param string $targetType
     * @param array $convertedChildProperties
     * @param PropertyMappingConfigurationInterface|null $configuration
     * @return string
     */
    public function convertFrom($source, $targetType, array $convertedChildProperties = [], PropertyMappingConfigurationInterface $configuration = null)
    {
        if (!is_string($source)) {
            return '';
        }
        // 执行手机号清洗逻辑
        return filter_var($source, FILTER_SANITIZE_NUMBER_INT);
    }
}

2. 在initializeAction中为telephone字段配置该转换器：

public function initializeRegisterCompleteAction()
{
    $this->arguments->getArgument('user')
        ->getPropertyMappingConfiguration()
        ->forProperty('telephone')
        ->setTypeConverter(\Your\Extension\Property\TypeConverter\TelephoneSanitizerConverter::class);
}

配置后，用户提交的原始手机号会先经过转换器清洗，再映射到User模型的telephone属性，后续验证（包括你的自定义UserValidator）拿到的就是清洗后的值。

方案2：在initializeAction中使用属性映射回调 #

如果不想单独创建转换器类，可直接在initializeAction中通过回调处理字段值，更适合简单的清洗逻辑：

public function initializeRegisterCompleteAction()
{
    $this->arguments->getArgument('user')
        ->getPropertyMappingConfiguration()
        ->forProperty('telephone')
        ->setCustomTypeConverter(function ($source) {
            return filter_var($source, FILTER_SANITIZE_NUMBER_INT);
        });
}

方案3：在模型setter方法中清洗 #

如果场景单一（仅用户输入时需要清洗），可以直接在User模型的setTelephone方法内处理：

class User extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity
{
    // ...

    public function setTelephone(string $telephone): void
    {
        $sanitizedTelephone = filter_var($telephone, FILTER_SANITIZE_NUMBER_INT);
        $this->telephone = $sanitizedTelephone;
    }
}

注意：该方法会在所有调用setTelephone的场景生效（包括从数据库加载后修改），若需仅针对用户输入场景，优先选择前两种方案。

关于验证器的补充 #

你之前在自定义验证器中修改模型无效，是因为Extbase验证时会传递模型的克隆对象，避免验证过程中修改原始数据。验证器的职责仅为判断值是否有效，不应该修改数据，这符合单一职责原则。

采用上述方案后，自定义UserValidator可直接使用清洗后的值做判断：

protected function validateTelephone(User $user): void
{
    $telephone = $user->getTelephone();
    if (empty($telephone)) {
        $this->result->forProperty('telephone')->addError(
            new Error('Invalid phone number', 1705061262334)
        );
    }
}

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