phpEnv 默认启用 iconv 扩展，但需验证底层 libiconv 是否支持 GB2312/GBK；若 iconv('UTF-8','GB2312','测试') 返回 false 或警告，说明 DLL 被裁剪，应替换为完整版 libiconv.dll 并重启服务。
phpEnv 默认已启用 iconv 扩展，无需手动开启 —— 但必须确认系统底层 libiconv 可用，否则 iconv() 调用会静默失败或返回空字符串。
检查 phpEnv 中 iconv 是否真正可用
很多用户以为 php -m | grep iconv 显示了就万事大吉，其实不是。phpEnv 是 Windows 下的集成环境（类似 XAMPP），它自带的 PHP 二进制可能链接的是精简版 iconv 实现，不支持常见中文编码如 GB2312、GBK。
执行以下代码验证实际能力：
var_dump(iconv('UTF-8', 'GB2312', '测试')); // 若返回 false 或警告，说明底层不支持
常见错误现象：Notice: iconv(): Detected an illegal character in input string 或直接返回空字符串，不是函数没加载，而是系统 iconv 库不认 GBK 类编码。
立即学习“PHP免费学习笔记（深入）”；
- 打开 phpEnv 控制面板 → 点击“PHP版本” → 查看当前 PHP 的
phpinfo()页面，在 “iconv” 模块区块中确认iconv implementation是libiconv还是glibc（Windows 下几乎肯定是前者） - 若显示
libiconv，再查iconv support是否为enabled；但即使 enabled，也不代表支持所有编码 - 最稳妥方式：运行
iconv -l（在 phpEnv 自带的 CMD 或终端里）看输出是否包含GB2312、GBK—— 如果没有，说明内置 iconv 数据库被裁剪过
替换 phpEnv 的 iconv.dll 以支持 GBK/GB2312
phpEnv 使用的 PHP 是静态编译的，其 iconv.dll 通常位于 phpEnv\php\php-{version}\ 目录下。原生 DLL 往往只含基础编码，需替换成 GNU libiconv 编译的完整版。
操作步骤：
- 去官网下载预编译的
libiconv.dll（推荐 winlibs 提供的 MinGW 版本，选带 iconv 的 release） - 备份原
phpEnv\php\php-{version}\iconv.dll - 将下载包里的
bin\iconv.dll复制到上述路径，覆盖（注意：不是php_iconv.dll，phpEnv 不用这个文件名） - 重启 phpEnv 的 Apache/Nginx 服务，再跑一次
iconv('UTF-8','GB2312','测试')验证
⚠️ 容易踩的坑：//ignore 和 //translit 后缀在部分精简版 iconv.dll 下无效，替换 DLL 后才真正生效。例如：iconv('UTF-8', 'GB2312//ignore', $str) 之前报错，替换后就能跳过乱码字节继续转换。
用 iconv() 做字符长度/截取时，别和 mbstring 混用
虽然 iconv_strlen()、iconv_substr() 看起来和 mb_strlen() 功能重叠，但在 phpEnv 这类 Windows 环境中，二者行为差异明显：
-
mbstring依赖php_mbstring.dll，默认可能未启用；而iconv是默认启用的（只要 DLL 正常） -
iconv_strlen($str, 'UTF-8')计算的是按 UTF-8 编码规则解析出的 Unicode 字符数，不是字节数 —— 这点和mb_strlen($str, 'UTF-8')一致 - 但
iconv_substr($str, 0, 2, 'UTF-8')的第三个参数是“字符数”，不是字节偏移；而原生substr()是按字节切的，切中文必乱 - 性能上，
iconv_*函数在小文本场景下略快于mb_*，因为不依赖额外扩展初始化逻辑
示例对比：
$str = "你好abc";<br>echo strlen($str); // 9（UTF-8 下每个汉字占 3 字节）<br>echo iconv_strlen($str, 'UTF-8'); // 5（正确字符数）<br>echo iconv_substr($str, 2, 2, 'UTF-8'); // "ab" —— 从第 3 个字符起取 2 个
导出 Excel 文件名含中文时的典型写法
这是 phpEnv 用户最高频的 iconv 使用场景：设置 Content-Disposition 中文文件名。关键点不是“能不能转”，而是“转完要不要加双引号+编码标记”。
- HTTP 协议规定，含非 ASCII 字符的 filename 必须用
filename*=UTF-8''{encoded}格式，但 IE/Edge 旧版只认filename+ GBK 编码 - 所以通用写法是同时提供两套：
header('Content-Type: application/vnd.ms-excel; charset=utf-8');<br>header('Content-Disposition: attachment; filename="data.xls"; filename*=UTF-8\'\''.rawurlencode(iconv('UTF-8','GBK',$name).'.xls'));
⚠️ 注意：iconv('UTF-8','GBK',$name) 必须确保前面已验证过 iconv.dll 支持 GBK，否则这里会崩。更保守的做法是 fallback 到拼音或时间戳：
$safe_name = @iconv('UTF-8','GBK',$name) ?: date('Ymd_His'); // 转换失败就用时间戳
复杂点在于：不同浏览器对 filename 的解析逻辑不一致，而 phpEnv 本地调试时往往只测 Chrome，上线后 IE 用户仍可能看到乱码 —— 这不是 PHP 层能完全解决的，得靠前端 JS download 属性兜底。
