大网数据广告活动
PHP 语言与运行手册

iconv · 将字符串从一个字符编码转换到另一个字符编码

· 52CE 我爱测

如果字符串 //TRANSLIT 追加到 to_encoding ,然后将启用转写(transliteration)功能。这意味着当字符不能被目标字符集所表示时,它可以通过一个或多个形似的字符来近似表达。 如果追加字符串 //IGNORE,不能以目标字符集表达的字符将被默默丢弃。否则,会导致 E_NOTICE 并返回 false。

iconv

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

iconv — 将字符串从一个字符编码转换到另一个字符编码

说明

function iconv(string $from_encoding, string $to_encoding, string $string): string|false

将 string 从 from_encoding 转换到 to_encoding。

参数

from_encoding

用于解释 string 的当前编码。

to_encoding

所需的结果编码。

如果字符串 //TRANSLIT 追加到 to_encoding ,然后将启用转写(transliteration)功能。这意味着当字符不能被目标字符集所表示时,它可以通过一个或多个形似的字符来近似表达。 如果追加字符串 //IGNORE,不能以目标字符集表达的字符将被默默丢弃。否则,会导致 E_NOTICE 并返回 false。

警告

//TRANSLIT 运行细节高度依赖于系统的 iconv() 实现(参见 ICONV_IMPL)。 据悉,某些系统上的实现会直接忽略 //TRANSLIT,所以转换也有可能失败,to_encoding 会是不合格的。

string

要转换的 string。

返回值

返回转换后的字符串, 或者在失败时返回 false。

示例

示例 #1 iconv() 示例

<?php
$text = "This is the Euro symbol '€'.";

echo 'Original : ', $text, PHP_EOL;
echo 'TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'IGNORE   : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Plain    : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;

?>

以上示例的输出类似于:

Original : This is the Euro symbol '€'.
TRANSLIT : This is the Euro symbol 'EUR'.
IGNORE   : This is the Euro symbol ''.
Plain    :
Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7

注释

注意:

可用的字符编码和选项取决于已安装的 iconv 实现。如果当前系统不支持 from_encoding 或 to_encoding 的参数,则返回 false。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。