应先运行 php -m | grep iconv 确认是否已启用 iconv 模块；若需手动指定路径，须用 --with-iconv=/path/to/libiconv（该路径下需同时存在 include/iconv.h 和 lib/libiconv.{a,so}），或分别通过 CFLAGS 和 LDFLAGS 指定头文件与库位置。
configure 时提示 “libiconv not found” 怎么办
这不是 PHP 自身缺失 iconv，而是
脚本找不到系统里已安装的
库文件（主要是
或
）和头文件（
）。常见于手动编译
到非标准路径（比如
），但 PHP configure 没有主动去那里找。
如何用 --with-iconv 指定自定义 iconv 路径
关键不是只加
，而是必须显式告诉 configure 头文件和库的位置：
：这个路径下必须同时包含
和
如果头文件在
、库在
，就写
如果分开存放（极少见），需额外加
，再配
configure 找不到 iconv.h 的典型表现和修复
错误日志里出现类似
或
，说明头文件没被发现：
先确认
真的存在：
或
如果它在
，但 configure 没扫到，就强制指定：
某些 Linux 发行版（如 Ubuntu）把
放在
包里，而非
包——此时应装系统包，而不是自己编译
链接时失败：undefined reference to `libiconv`
configure 成功了，但
报
，说明链接阶段没找到符号：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
检查
库类型：PHP 需要静态库（
）或带导出符号的动态库；macOS 上若用 Homebrew 安装的
，默认是 .dylib，且可能被系统 iconv 覆盖
用
确认符号是否存在
若用
，确保
存在；没有的话，重新编译
加
macOS 上还可能因 SIP 限制无法链接非系统路径的 dylib，建议优先用
或改用系统自带 iconv（不加
让 PHP 自动 fallback）
最常被忽略的是：不同平台对
的依赖方式差异很大。Linux 上通常直接用 glibc 自带 iconv，根本不需要额外装；macOS 自 Xcode 15 起已移除
，强行链接旧版本会直接失败。动手前先
看是否已有模块，比硬怼 configure 更省事。
./configurelibiconvlibiconv.alibiconv.soiconv.hlibiconv/usr/local--with-iconv--with-iconv=/path/to/libiconvinclude/iconv.hlib/libiconv.{a,so}/opt/libiconv/include/opt/libiconv/lib--with-iconv=/opt/libiconvCFLAGS="-I/path/to/include" LDFLAGS="-L/path/to/lib"--with-iconviconv.h: No such file or directorycannot find iconviconv.hfind /usr -name iconv.h 2>/dev/nullfind /usr/local -name iconv.h 2>/dev/null/usr/local/include/iconv.hCFLAGS="-I/usr/local/include" ./configure --with-iconv=/usr/local ...iconv.hlibc6-devlibiconvlibiconvmakeundefined reference to 'libiconv_open'libiconv.alibiconvnm -D /path/to/lib/libiconv.so | grep iconv_open--with-iconv=/usr/local/usr/local/lib/libiconv.alibiconv--enable-static.a--with-iconvlibiconvlibiconv.2.4.0.tbdphp -m | grep iconv