README

介绍

UConvert 当前允许您在越南语言的编码之间进行转换。目前支持 4 种编码

• UNICODE
• VNI
• TCVN3
• VIQR

未来将很快支持其他编码。

UConvert 中用于转换的数据来源于： http://vietunicode.sourceforge.net/charset

安装

UConvert 可在 Github 和 Packagist 上找到，因此您可以通过两种基本方式安装它

通过 Composer

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

"require": {
	"anhskohbo/u-convert": "dev-master"
}

接下来，更新包

composer update

手动

如果您对 Composer 不太熟悉，出于某种原因，UConvert 提供了一种手动方式将其嵌入到您的项目中。

首先，从 此处 下载 UConvert

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

将其嵌入到您需要使用的地方

<?php

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

//..

使用

编码名称标准

在使用之前，您需要了解 UConvert 使用的编码名称标准。

所有编码名称都必须 必须 大写且不区分大小写。例如 UNICODE、VNI、TCVN3、VIQR...

在 Anhskohbo\UConvert\UConvert 类中，一些常量被声明，以帮助您保持编码名称的一致性

<?php

namespace Anhskohbo\UConvert;

class UConvert implements UConvertInterface {

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

常规初始化

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

<?php
// Autoload library...

use Anhskohbo\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 的构造函数接受 2 个参数

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

$text：您想要转换的内容。

$character：它当前的编码名称。

初始化后，您需要调用方法 transform(string $toCharacter)，并传入要转换到的编码名称，以将其转换为最终编码。

直接调用静态方法。

此外，除了初始化类之外，UConvert 允许您直接调用一些特殊的静态方法进行转换。

这些特殊静态方法是： to + 编码名称（在系统中存在）连续大写。

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

<?php

use Anhskohbo\UConvert\UConvert;

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

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

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

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

限制

• 尚未完全支持所有编码（将很快支持）。
• 缺少自动识别输入字符串的编码机制（正在考虑，但遇到一些正则表达式的问题 @@）
• 从 text 文件、word、excel... 中读取、转换和写入
• ...

贡献

如果您有任何修改、新增等，您可以通过以下方式操作：在以下链接发送pull-request：https://github.com/anhskohbo/u-convert/pulls