README

介绍

这是一个围绕PHP的mb_convert_encoding和iconv函数的包装器。此库添加了

• 从mb到iconv的回退以处理未知编码
• 将警告转换为适当的异常。

安装

推荐通过Composer安装Transcoder库

$ 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。