README

简介

这是一个围绕PHP的mb_convert_encoding和iconv函数的包装器。这个库添加了以下功能：

• 从mb到iconv的回退，用于未知编码
• 将警告转换为适当的异常。

安装

安装Transcoder库的推荐方法是使用Composer

$ composer require ddeboer/transcoder

此命令要求您全局安装Composer，如Composer文档中的安装章节中所述。

用法

基础

为您的平台创建合适的转换器并翻译一些字符串

use Ddeboer\Transcoder\Transcoder;

$transcoder = Transcoder::create();
$result = $transcoder->transcode('España');

您还可以手动实例化一个您喜欢的转换器

use Ddeboer\Transcoder\MbTranscoder;

$transcoder = new MbTranscoder();

或者

use Ddeboer\Transcoder\IconvTranscoder;

$transcoder = new IconvTranscoder();

源编码

默认情况下，源编码会自动检测。但是，当您显式指定它时，您会得到更可靠的结果

$transcoder->transcode('España', 'iso-8859-1');

目标编码

将默认目标编码指定为create()的第一个参数

use Ddeboer\Transcoder\Transcoder;

$isoTranscoder = Transcoder::create('iso-8859-1');

或者，在transcode()调用中将目标编码指定为第三个参数

use Ddeboer\Transcoder\Transcoder;

$transcoder->transcode('España', null, 'UTF-8'); 

错误处理

PHP的mb_convert_encoding和iconv使用不便，因为它们生成通知和警告而不是适当的异常。这个库解决了这个问题

use Ddeboer\Transcoder\Exception\UndetectableEncodingException;
use Ddeboer\Transcoder\Exception\UnsupportedEncodingException;
use Ddeboer\Transcoder\Exception\IllegalCharacterException;

$input = 'España';
 
try {
    $transcoder->transcode($input);
} catch (UndetectableEncodingException $e) {
    // Failed to automatically detect $input’s encoding 
}

try {
    $transcoder->transcode($input, null, 'not-a-real-encoding');
} catch (UnsupportedEncodingException $e) {
    // ‘not-a-real-encoding’ is an unsupported encoding 
}

try {
    $transcoder->transcode('Illegal quotes: ‘ ’', null, 'iso-8859-1');
} catch (IllegalCharacterException $e) {
    // Curly quotes ‘ ’ are illegal in ISO-8859-1
}

转换器回退

一般来说，mb_convert_encoding比iconv更快。然而，由于iconv支持的编码比mb_convert_encoding多，将两者结合是有意义的。

所以，从create()返回的转换器

• 如果安装了mbstring PHP扩展，则使用mb_convert_encoding；
• 如果没有，则使用iconv，如果安装了iconv扩展；
• 如果mbstring和iconv扩展都可用，转换器将首先尝试mb_convert_encoding并回退到iconv。