phpEnv 默认内置 iconv 扩展，但需确认 PHP 编译时链接了 libiconv 库，否则 iconv() 会报错或返回 false；应通过 function_exists('iconv') 和实际转换测试验证可用性，而非仅依赖 php -m 查看模块加载。
phpEnv 默认已内置 iconv 扩展，无需额外安装 —— 但必须确认当前 PHP 版本编译时启用了 libiconv 支持，否则 iconv() 函数会报错或返回空。
检查 iconv 是否真正可用
很多用户以为“php -m | grep iconv”有输出就代表能用，其实不是。phpEnv 打包的 PHP 可能只是加载了扩展模块，但底层缺失 libiconv 库支持，导致运行时报 Notice: iconv(): Wrong charset, conversion from 'GBK' to 'UTF-8' is not allowed 或直接返回 false。
- 执行
php -r "var_dump(function_exists('iconv'));"，确认函数存在 - 再执行
php -r "var_dump(iconv('UTF-8', 'GBK', '测试'));"，看是否真实转换成功（注意：部分 Windows 环境下 GBK 不被原生 iconv 支持，建议先试GB18030） - 若失败，运行
php -i | grep -i iconv，重点查看iconv support行是否为enabled，以及iconv implementation是否为glibc或libiconv（Windows 下常见是libiconv，但 phpEnv 若用 MinGW 编译可能 fallback 到不完整实现）
Windows 下 phpEnv 启用完整 iconv 的关键步骤
phpEnv for Windows 默认使用预编译 PHP 二进制包，其 iconv 实现依赖于打包时链接的 libiconv.dll。若你遇到乱码、转换失败或 iconv_get_encoding() 返回空数组，大概率是 DLL 缺失或版本不匹配。
- 进入 phpEnv 安装目录下的
php\version\php-xx.x.x\子目录（如php\8.3.13\） - 检查是否存在
libiconv.dll文件；若不存在，需手动放入 —— 推荐从 official libiconv releases 下载最新 Windows x64/x86 DLL（与 PHP 架构一致），重命名为libiconv.dll并放至该目录 - 确保
php.ini中未禁用扩展：extension=iconv这行不能被分号注释，且不要写成extension=php_iconv.dll（Windows 下现代 PHP 已统一用iconv模块名） - 重启 phpEnv 控制面板或 Apache/Nginx 服务使配置生效
Linux/macOS 下通过 phpenv + php-build 编译启用 iconv
如果你用的是源码管理型 phpenv（非 Windows 图形版），而目标 PHP 版本没有 iconv，问题通常出在系统缺少开发头文件或编译时未启用。
立即学习“PHP免费学习笔记（深入）”；
- 先安装系统依赖：
sudo apt install libiconv-dev（Ubuntu/Debian）或brew install libiconv（macOS） - 设置编译环境变量避免 fallback：
export CONFIGURE_ARGS="--with-iconv-dir=/usr"（Linux）或export CONFIGURE_ARGS="--with-iconv-dir=$(brew --prefix libiconv)"（macOS） - 再执行：
phpenv install 8.3.13—— 此时 php-build 会显式链接 libiconv - 验证：
phpenv local 8.3.13 && php -r "echo iconv('UTF-8','GB18030','中文');"
真正容易被忽略的点是：iconv 的字符集名称大小写敏感，且不同系统支持列表不同。比如 gbk 在 GNU libiconv 中可用，但在某些 glibc 环境下必须写成 GBK 或改用 GB18030；UTF-8//IGNORE 这类修饰符在 Windows 下部分版本不支持 —— 遇到转换失败，优先换字符集名，而不是怀疑扩展没开。
