README

[] (https://github.com/ThrusterIO/data-mapper/releases) [] (LICENSE) [] (https://travis-ci.org/ThrusterIO/data-mapper) [] (https://scrutinizer-ci.com/g/ThrusterIO/data-mapper) [] (https://scrutinizer-ci.com/g/ThrusterIO/data-mapper) [] (https://packagist.org.cn/packages/thruster/data-mapper)

[] (mailto:team@thruster.io)

Thruster 数据映射组件。提供了一种快速高效地将数据从一种格式映射到另一种格式的解决方案。

安装

通过 Composer

$ composer require thruster/data-mapper

适用于 PHP < 7.0

对于比 PHP7 更旧的版本，存在 php5 分支

$ composer require thruster/data-mapper ">=1.0,<2.0"

用法

简单数据映射

class SimpleMapper extends BaseDataMapper {
    /**
     * @param Request $input
     */
    public function map($input)
    {
        return [
            'id' => $input->getId(),
            'name' => $input->getName()
        ];
    }
}

$dataMappers = new DataMappers();
$dataMappers->addMapper(new SimpleMapper());
$dataMappers->getMapper(SimpleMapper::class)->map($input);

嵌套数据映射

class ItemMapper extends BaseDataMapper {
    /**
     * @param Request $input
     */
    public function map($input)
    {
        return [
            'id' => $input->getId(),
            'name' => $input->getName()
        ];
    }
}

class MainMapper extends BaseDataMapper {
    /**
     * @param Request $input
     */
    public function map($input)
    {
        return [
            'id' => $input->getId(),
            'name' => $input->getName(),
            'items' => $this->getMapper(ItemMapper::class)->mapCollection($input->getItems())
        ];
    }
}

$dataMappers = new DataMappers();
$dataMappers->addMapper(new MainMapper());
$dataMappers->addMapper(new ItemMapper());
$dataMappers->getMapper(MainMapper::class)->map($input);

可验证数据映射

class UserRegistrationMapper extends BaseDataMapper implements ValidateableDataMapperInterface {
    /**
     * @param Request $input
     */
    public function map($input)
    {
        $user = new User();
        
        $user->setUsername($input->get('username'));
        $user->setPassword($input->get('password'));
    }

    public function supports($input) : bool
    {
        return ($input instanceof Request);
    }
    
    public function getValidationGroups($input) : array
    {
        return ['full'];
    }
}

$dataMappers = new DataMappers();
$dataMappers->setValidator(Validation::createValidator());

$dataMappers->addMapper(new UserRegistrationMapper());
$dataMappers->getMapper(UserRegistrationMapper::class)->map($input);

独立数据映射

$simpleMapper = new DataMapper(
    new class extends BaseDataMapper {
        /**
         * @param Request $input
         */
        public function map($input)
        {
            return [
                'id' => $input->getId(),
                'name' => $input->getName()
            ];
        }
    
        public function supports($input) : bool
        {
            return true;
        }
    }
);

$simpleMapper->map($input);

测试

$ composer test

贡献

请参阅CONTRIBUTING和CONDUCT以获取详细信息。

许可证

有关更多信息，请参阅许可证文件。