Lý do

Vừa qua thì mình có việc phải đọc dữ liệu từ text-file rồi insert vào CSDL. Tưởng dễ ăn lắm, nhưng than ôi! Thật là khó nhằn!!! Ngoài những file nội dung tiếng Anh ra, còn tiếng Việt thì phần lớn được viết theo kiểu VNI.

Thế là đành tìm trên github với packagist: "VNI", "Unicode", "TCVN3"... không có! Quay sang tra google: "Chuyển đổi VNI sang Unicode với PHP", tìm được vài bài đăng cách chuyển đổi VNI sang Unicode tuy nhiên phần lớn là theo cơ chế lookup rồi thay thế cơ bản nên còn không đúng.

Tiếp tục tra google đi ra ngoài phạm vi PHP thì có khá nhiều cái viết cho js, python, java... hoạt động ổn. Chọn một cái mang tính open-source dùng nó viết hàm vni2unicode() để giải quyết vấn đề tạm thời.

Đến bữa nay rảnh, ngồi đọc code mãi cũng chán thành thử có ý định viết nâng cao hơn cả vni2unicode ngồi google, tra bảng mã, tìm hiểu cơ chế các soft khác... cuối cùng cũng viết ra được cái này.

Nếu bạn đang cần xử lý một tình huống tương tự, chắc hẳn bạn sẽ cần đến thư viện này!

Giới thiệu

UConvert hiện tại cho phép bạn chuyển đổi qua lại giữa các bảng mã của tiếng Việt. Hiện tại hỗ trợ 4 bảng mã:

  • UNICODE
  • VNI
  • TCVN3
  • VIQR

Sẽ sớm hỗ trợ các bảng mã còn lại trong tương lai.

Dữ liệu được dùng để chuyển đổi trong UConvert được lấy từ địa chỉ: http://vietunicode.sourceforge.net/charset

Cài đặt

UConvert có sẵn trên Github và Packagist, vậy nên bạn có thể cài đặt nó qua 2 cách cơ bản:

Qua Composer

Nếu bạn sử dụng Composer để quản lý thư viện cho dự án của mình, một cách dễ dàng nhất, thêm "anhskohbo/u-convert": "dev-master" vào phần require trong file composer.json:

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

Tiếp theo, update lại các gói:

composer update

Thủ công

Nếu bạn chưa quen với Composer vì lý do gì, UConvert cho bạn một cách thủ công để nhúng nó vào dự án của bạn.

Đầu tiên, tải UConvert tại đây:

Giải nén tập tin và bạn nên để tên thư mục chứa mã nguồn là u-convert. Ném nó vào thư mục chứa thư viện bên thứ 3 của bạn hoặc bất cứ nơi đâu bạn thích :)

Nhúng nó vào nơi bạn cần sử dụng:

<?php

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

//..

Sử dụng

Quy chuẩn về tên bảng mã

Trước khi vào phần sử dụng bạn cần biết tên chuẩn của các bảng mã mà UConvert sử dụng.

Tất cả các tên bảng mã đều phải viết HOA và liền không dấu. Ví dụ UNICODE, VNI, TCVN3, VIQR...

Trong lớp Anhskohbo\UConvert\UConvert một số hằng được khai báo giúp bạn nhất quán trong việc gọi tên bảng mã:

<?php

namespace Anhskohbo\UConvert;

class UConvert implements UConvertInterface {

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

Khởi tạo thông thường

UConvert cung cấp một cách rất dễ dàng để sử dụng, hãy xem một ví dụ:

<?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

Construct của UConvert chấp nhận 2 đối số:

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

$text: Nội dung bạn muốn chuyển đổi.

$character: Tên bảng mã hiện tại của nó.

Sau khi khởi tạo bạn cần gọi method transform(string $toCharacter) với tham số là tên bảng mã cần chuyển đến để chuyển nó sang bảng mã cuối.

Gọi trực tiếp qua static.

Ngoài ra thay vì phải khởi tạo lớp, UConvert cho phéo bạn gọi trực tiếp tới một số static-method đặc biệt chuyển đổi.

Những static-method đặc biệt là: to + tên bảng mã sẵn có (trong hệ thống) viết liền và viết hoa chữ cái đầu.

Dưới đây là một ví dụ gọi trực tiếp kiểu static:

<?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);

Hạn chế

  • Chưa hỗ trợ đầy đủ các bảng mã (sẽ dần có sớm).
  • Thiếu cơ chế tự động nhận diện bảng mã của chuỗi nhập vào (đang xem xét tuy nhiên gặp khó khăn vài regex kém @@)
  • Đọc, chuyển đổi và ghi từ text-file, hay word, excel...
  • ...

Đóng góp

Thư viện được cấp giấy phép MIT nên bạn có thể sửa đổi hay phân phát lại nó. Nếu bạn có bất kỳ chỉnh sửa, thêm mới... bạn có thể:

Gửi pull-request tại: https://github.com/anhskohbo/u-convert/pulls

Tôi rất sẵn lòng!

Thông tin gói