应先运行 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，而是 ./configure 脚本找不到系统里已安装的 libiconv 库文件（主要是 libiconv.a 或 libiconv.so）和头文件（iconv.h）。常见于手动编译 libiconv 到非标准路径（比如 /usr/local），但 PHP configure 没有主动去那里找。
如何用 --with-iconv 指定自定义 iconv 路径
关键不是只加 --with-iconv，而是必须显式告诉 configure 头文件和库的位置：
-
--with-iconv=/path/to/libiconv：这个路径下必须同时包含include/iconv.h和lib/libiconv.{a,so} - 如果头文件在
/opt/libiconv/include、库在/opt/libiconv/lib，就写--with-iconv=/opt/libiconv - 如果分开存放（极少见），需额外加
CFLAGS="-I/path/to/include" LDFLAGS="-L/path/to/lib"，再配--with-iconv
configure 找不到 iconv.h 的典型表现和修复
错误日志里出现类似 iconv.h: No such file or directory 或 cannot find iconv，说明头文件没被发现：
- 先确认
iconv.h真的存在：find /usr -name iconv.h 2>/dev/null或find /usr/local -name iconv.h 2>/dev/null - 如果它在
/usr/local/include/iconv.h，但 configure 没扫到，就强制指定：CFLAGS="-I/usr/local/include" ./configure --with-iconv=/usr/local ... - 某些 Linux 发行版（如 Ubuntu）把
iconv.h放在libc6-dev包里，而非libiconv包——此时应装系统包，而不是自己编译libiconv
链接时失败：undefined reference to `libiconv`
configure 成功了，但 make 报 undefined reference to 'libiconv_open'，说明链接阶段没找到符号：
立即学习“PHP免费学习笔记（深入）”；
- 检查
libiconv库类型：PHP 需要静态库（.a）或带导出符号的动态库；macOS 上若用 Homebrew 安装的libiconv，默认是 .dylib，且可能被系统 iconv 覆盖 - 用
nm -D /path/to/lib/libiconv.so | grep iconv_open确认符号是否存在 - 若用
--with-iconv=/usr/local，确保/usr/local/lib/libiconv.a存在；没有的话，重新编译libiconv加--enable-static - macOS 上还可能因 SIP 限制无法链接非系统路径的 dylib，建议优先用
.a或改用系统自带 iconv（不加--with-iconv让 PHP 自动 fallback）
最常被忽略的是：不同平台对 libiconv 的依赖方式差异很大。Linux 上通常直接用 glibc 自带 iconv，根本不需要额外装；macOS 自 Xcode 15 起已移除 libiconv.2.4.0.tbd，强行链接旧版本会直接失败。动手前先 php -m | grep iconv 看是否已有模块，比硬怼 configure 更省事。
