zclwy/translation

translate field，将字段变更翻译成相应文案

v1.0.2 2022-06-08 07:33 UTC

Requires

• php: >=7.4
• ext-json: *

Requires (Dev)

• phpunit/phpunit: >=6.0

MIT

• zhangchunlong

• translate
• translate field

README

特性

• 支持多维数组
• 支持新旧数据变更翻译
• 配置简单且多样
• 支持json数据
• 支持扩展

安装

使用composer安装

composer require zclwy/translation

一、使用

1、简单使用

use Zclwy\Translation\Translation;

$configs = [
    'name' => '名字'
];
$data = [
    'name' => '我是一个名字'
];
$tpl = '【:attribute】值为“:value”';
$tran = new Translation($configs, $tpl);
$tran->translate($data);
echo $tran; // 【名字】值为“我是一个名字”
echo $tran->getTranslateString(); // 【名字】值为“我是一个名字”

2、支持值映射

use Zclwy\Translation\Translation;

$configs = [
    'type' => [
        'text' => '名字',
        'value' => [1 => '名字A', 2 => '名字B', 3 => '名字C']
    ],
];
$data = [
    'type' => 3
];
$tpl = '【:attribute】值为“:value”';
$tran = new Translation($configs, $tpl);
$tran->translate($data);
echo $tran->getTranslateString(); // 【名字】值为“名字C”

3、支持关联字段映射,解决字段复用问题

use Zclwy\Translation\Translation;

$configs = [
    'type' => [
        'text' => '名字',
        'value' => [1 => '名字A', 2 => '名字B', 3 => '名字C']
    ],
    'extra.jump_type' => [
        'text' => '类型',
        'value' => ['webview' => '网页类', 'download' => '下载类', 'deeplink' => '拉起应用',]
    ],
    'extra.url' => [
        'relevance' => [
            'type' => [
                1 => '跳转链接',
                2 => '下载链接',
                3 => [
                    'relevance' => [
                        'extra.jump_type' => [
                            'webview' => '广告链接',
                            'download' => '广告链接',
                            'deeplink' => '备用链接',
                        ]
                    ]
                ],
            ],
        ],
    ],
];
$data = [
    'type' => 3,
//    'extra' => '{"title":"标题111", "jump_type":"deeplink", "img":"图片地址", "deeplink":"deeplink://", "url":"http://www.baidu.com"}', // 支持json
    'extra' => json_decode('{"title":"标题111", "jump_type":"deeplink", "img":"图片地址", "deeplink":"deeplink://", "url":"http://www.baidu.com"}', true),
];
$tpl = '【:attribute】值为“:value”';
$tran = new Translation($configs, $tpl);
$tran->translate($data);
echo $tran->getTranslateString(); // 【名字】值为“名字C”;【跳转类型】值为“拉起应用类”;【广告链接】值为“http://www.baidu.com”

4、值映射支持callback

use Zclwy\Translation\Translation;

$configs = [
    'plan_id' => [
        'text' => '名称',
        'value' => function ($value, $attribute, $translation) {
            if (empty($value)) {
                return null;
            }
            // 查询
            $res = [
                [
                    'id' => 1,
                    'name' => '公告1',
                ],
                [
                    'id' => 2,
                    'name' => '公告2',
                ]
            ];
            $arr = array_column($res, 'name', 'id');
            return $arr[$value];
        }
    ],
];
$data = [
    'plan_id' => 1
];
$tpl = '【:attribute】值为“:value”';
$tran = new Translation($configs, $tpl);
$tran->translate($data);
echo $tran->getTranslateString(); 

5、支持新旧数据变更翻译

use Zclwy\Translation\Translation;

$configs = [
    'name' => '名称',
    'type' => [
        'text' => '类型',
        'value' => [1 => '资讯', 2 => '公告', 3 => '广告']
    ],
    'extra.title' => '标题',
    'extra.img' => '图片',
    'extra.deeplink' => 'deeplink',
    'extra.jump_type' => [
        'text' => '跳转类型',
        'value' => ['webview' => '网页类', 'download' => '下载类', 'deeplink' => '拉起应用类', 'noclick' => '不可点击']
    ],
    'extra.url' => [
        'relevance' => [
            'type' => [
                1 => '链接',
                2 => '链接',
                3 => [
                    'relevance' => [
                        'extra.jump_type' => [
                            'webview' => '广告链接',
                            'download' => '广告链接',
                            'deeplink' => '备用链接',
                        ]
                    ]
                ],
            ],
        ],
    ],
];
$data = [
    'name' => '内容',
    'type' => 3,
    'extra' => '{"title":"标题111", "jump_type":"deeplink", "img":"图片地址", "deeplink":"deeplink://", "url":"http://www.baidu.com"}',
];
$oldData = [
    'name' => '内容2',
    'type' => 2,
    'extra' => '{"title":"标题222", "img":"图片222://", "url":"http://www.baidu2222.com"}',
];

$tpl = '【:attribute】值由“:oldValue”改为“:value”';
$tran = new Translation($configs, $tpl);
$tran->translate($data, $oldData);
echo $tran->getTranslateString();