PHP函数iconv()编码转换

封面图 • 2025-12-25 • PHP

在 PHP 中，`iconv()` 是一个用于字符编码转换的函数。它可以将字符串从一种编码格式转换为另一种编码格式。

---

## 📌 函数原型：

```php
string iconv ( string $in_charset , string $out_charset , string $str )
```

### 参数说明：

- **`$in_charset`**：输入字符串的当前编码（例如：`UTF-8`, `GBK`, `ISO-8859-1` 等）。
- **`$out_charset`**：要转换成的目标编码（例如：`UTF-8`, `GB2312`, `ASCII` 等）。
- **`$str`**：需要进行编码转换的字符串。

### 返回值：

返回转换后的字符串；如果转换失败，则返回 `false`。

---

## ✅ 示例：

### 示例 1：将 GBK 编码的字符串转为 UTF-8

```php
$gbk_str = "你好，世界！";
$utf8_str = iconv("GBK", "UTF-8", $gbk_str);
echo $utf8_str; // 输出：你好，世界！
```

### 示例 2：将 UTF-8 转为 GBK

```php
$utf8_str = "Hello, World!";
$gbk_str = iconv("UTF-8", "GBK", $utf8_str);
echo $gbk_str; // 输出：Hello, World!
```

> 注意：如果原字符串中存在无法转换的字符，`iconv()` 会默认跳过这些字符，不会报错。可以通过设置第三个参数来控制行为。

---

## 🧠 可选参数：错误处理

`iconv()` 的第三个参数可以是：

- `//IGNORE`：忽略无法转换的字符。
- `//TRANSLIT`：尝试用近似的字符代替无法转换的字符。

### 示例：

```php
$utf8_str = "Café";
$iso_str = iconv("UTF-8", "ISO-8859-1//IGNORE", $utf8_str);
echo $iso_str; // 输出：Cafe

$iso_str_translit = iconv("UTF-8", "ISO-8859-1//TRANSLIT", $utf8_str);
echo $iso_str_translit; // 输出：Cafe
```

---

## ⚠️ 注意事项：

- 如果你使用的是 PHP 7.0+，推荐使用 `mb_convert_encoding()` 替代 `iconv()`，因为 `mbstring` 扩展更强大、兼容性更好。
- `iconv()` 在某些系统上可能不支持所有编码，特别是 Windows 系统。
- 使用前请确认你的 PHP 安装是否启用了 `iconv` 扩展。

---

## 🔍 常见编码格式：

| 编码格式 | 描述 |
|----------|------|
| UTF-8    | 万国码，广泛用于 Web 和现代应用 |
| GBK      | 中文编码，常用于简体中文环境 |
| GB2312   | 简体中文编码，较旧 |
| ISO-8859-1 | 欧洲语言编码，如英语、法语等 |
| ASCII    | 英文字符编码 |

---

## ✅ 总结：

- `iconv()` 是 PHP 中用于编码转换的函数。
- 支持多种编码格式，但需要注意兼容性和错误处理。
- 推荐使用 `mb_convert_encoding()` 作为替代方案（如果可用）。

如果你有具体的编码问题或代码示例，欢迎继续提问！