README

介绍

UConvert当前允许您在越南的字符集（Unicode、VNI、TCVN3、VIQR）之间进行转换。目前支持4个字符集

• UNICODE
• VNI
• TCVN3
• VIQR

未来将很快支持其他字符集。

安装

UConvert可在Github和

通过Composer获取

如果您使用Composer来管理项目库，最简单的方式是将"visualweber/unicode-converter": "dev-master"添加到composer.json文件中的require部分

"require": {
	"visualweber/unicode-converter": "dev-master"
}

接下来，更新包

composer update

手动

如果您由于某种原因不熟悉Composer，UConvert为您提供了一种手动将其嵌入项目的方法。

首先，下载UConvert : (https://github.com/visualweber/unicode-converter/archive/master.zip)

解压文件，并将包含源代码的文件夹命名为u-convert。将其放入您喜欢的第三方库文件夹或任何地方 :)

将其放置在需要使用的地方

<?php

require '/path-to-libs/u-convert/autoload.php';

//..

使用

关于字符集名称的规范

在使用部分之前，您需要了解UConvert使用的字符集名称。

所有字符集名称都必须写为全大写，且无空格。例如 UNICODE、VNI、TCVN3、VIQR...

在UConvert\UConvert类中，一些常量被声明，以帮助您在调用名称时保持一致性

<?php

namespace UConvert;

class UConvert implements UConvertInterface {

	const UNICODE = 'UNICODE';
	const TCVN3   = 'TCVN3';
	const VNI     = 'VNI';
	const VIQR    = 'VIQR';

正常初始化

UConvert提供了一种非常简单的方式来使用，请看以下示例

<?php
// Autoload library...

use UConvert\UConvert;

$vni_string = "Xin chaøo theá giôùi";

// Khoi tao UConvert voi string va bang ma cua no.
$convert    = new UConvert($vni_string, UConvert::VNI);

// Chuyen doi sang UNICODE
echo $convert->transform(UConvert::UNICODE);

// Output: Xin chào thế giới

UConvert的构造函数接受两个参数

UConvert\UConvert( string $text, string $character)

$text: 您要转换的内容。

$character: 它当前的字符集名称。

初始化后，您需要调用带有参数的transform(string $toCharacter)方法，参数为要转换到的字符集名称，以将其转换为最终的字符集。

直接通过静态方法调用。

此外，UConvert允许您直接调用一些特殊的静态方法进行转换。

这些特殊的静态方法是：to + 已有字符集名称（在系统中）连续写法和首字母大写。

以下是一个直接调用静态方法的示例

<?php

use UConvert\UConvert;

UConvert::toUnicode($vni, UConvert::VIQR);

UConvert::toVni($unicde, UConvert::UNICODE);

UConvert::toTcvn3($vni, UConvert::VNI);

Convert::toViqr($tcvn3, UConvert::TCVN3);

限制

• 尚未完全支持所有字符集（将很快支持）。
• 缺少自动识别输入字符串的字符集机制（正在考虑，但遇到了几个正则表达式的问题）
• 从text-file、word、excel...读取、转换和写入
• ...

贡献

如果您有任何修改、新增等，您可以在以下位置发送pull-request：https://github.com/visualweber/unicode-converter/pulls