函数名:mb_convert_encoding()
适用版本:PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8
函数描述:mb_convert_encoding() 函数将字符串从一个字符编码转换为另一个字符编码。
用法:string mb_convert_encoding ( string $str , string $to_encoding [, mixed $from_encoding = mb_internal_encoding() ] ) : string|false
参数:
- $str:需要转换编码的字符串。
- $to_encoding:目标字符编码,可以是一个字符编码字符串,或者是一个字符编码数组。
- $from_encoding:原始字符编码,可选参数。如果未指定,则默认使用 mb_internal_encoding() 函数返回的字符编码。
返回值:
- 如果转换成功,则返回转换后的字符串。
- 如果转换失败,则返回 false。
示例:
// 将一个字符串从 ISO-8859-1 编码转换为 UTF-8 编码
$str = "Hello, 你好!";
$convertedStr = mb_convert_encoding($str, "UTF-8", "ISO-8859-1");
echo $convertedStr;
// 输出:Hello, 你好!
// 将一个字符串从 UTF-8 编码转换为 GBK 编码
$str = "Hello, 你好!";
$convertedStr = mb_convert_encoding($str, "GBK", "UTF-8");
echo $convertedStr;
// 输出:Hello, 你好!(在GBK编码下显示)
注意事项:
- 该函数依赖于多字节字符串扩展(mbstring extension),需要在 PHP 配置中启用该扩展。
- 如果未指定原始字符编码,则默认使用 mb_internal_encoding() 函数返回的字符编码。
- 如果指定的字符编码不可用或不支持,则转换失败,返回 false。
- 该函数可以一次性将一个字符串从一个字符编码转换为多个目标字符编码。如果 $to_encoding 参数是一个字符编码数组,函数将返回一个包含多个转换后字符串的数组。