configure提示“libiconv not found”是因脚本未找到iconv.h或libiconv.{a,so}，常见于libiconv装在非标准路径；须用cflags和ldflags显式指定头文件与库位置，或确保--with-iconv路径下同时存在include/iconv.h和lib/libiconv.{a,so}。
configure时加--with-iconv但依然报libiconv not found
这不是PHP没装libiconv，而是./configure脚本压根没找到它的头文件iconv.h或库文件libiconv.so/libiconv.a。常见于libiconv被装在/usr/local或/opt这类非标准路径，而PHP默认只扫/usr和/usr/local的顶层目录。
必须显式告诉编译器头文件和库在哪：
- 如果
iconv.h在/usr/local/include/iconv.h、libiconv.so在/usr/local/lib/，就用：CFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib" ./configure --with-iconv=/usr/local - 如果头文件在
/opt/libiconv/include、库在/opt/libiconv/lib，则写：CFLAGS="-I/opt/libiconv/include" LDFLAGS="-L/opt/libiconv/lib" ./configure --with-iconv=/opt/libiconv - Ubuntu/Debian用户注意：
iconv.h常在libc6-dev包里，不是libiconv包——此时别自己编译libiconv，直接apt install libc6-dev更稳
make时报undefined reference to 'libiconv_open'
configure过了，但链接阶段失败，说明libiconv符号没被正确导入。关键看库类型和路径是否匹配：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 用
nm -D /path/to/lib/libiconv.so | grep iconv_open确认符号是否存在；没有就说明是阉割版或静态库没编译进 - PHP编译需要
.a（静态）或带导出符号的.so（动态），macOS上Homebrew装的libiconv默认是.dylib，且可能被系统iconv覆盖 - 若用了
--with-iconv=/usr/local，但/usr/local/lib/libiconv.a不存在，就得重装libiconv并加--enable-static - CentOS/Rocky下，确保
/etc/ld.so.conf.d/libiconv.conf里写了/usr/lib64或/usr/local/lib64，然后跑ldconfig
宝塔面板里编译Swoole时libiconv冲突怎么办
宝塔默认PHP配置会自动探测libiconv，但路径判断经常不准，尤其当系统有多个libiconv版本共存时。最省事的解法是绕过它：
- 进宝塔PHP管理页 → 编辑安装配置 → 在“编译参数”末尾加：
--without-iconv（禁用iconv支持，适用于不依赖字符集转换的项目） - 若项目强依赖iconv（比如老版Discuz!或某些支付SDK），先确认
/usr/lib64/libiconv.so存在，再加：--with-iconv=/usr - 加了
--with-iconv但没指定路径，或路径下没lib/libiconv.so，configure可能通过，make时仍报错 - 扩展编译成功但
php -m | grep swoole不显示，大概率是运行时找不到libiconv.so——检查ldd /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/swoole.so | grep iconv
phpEnv环境下指定libiconv路径的实操要点
phpEnv本身不干预PHP编译参数，但它管理的PHP实例路径分散，容易在Swoole编译时漏掉libiconv关联。重点不是改Swoole参数，而是确保底层PHP已正确定义libiconv：
- 先查当前phpEnv PHP版本的
php-config输出：~/.phpenv/versions/8.1.22/bin/php-config --configure-options，看里面有没有--with-iconv或--without-iconv - 如果没有，说明这个PHP实例根本没启用iconv——得先重装该PHP版本，加上
--with-iconv=/usr或对应路径 - 如果已有，编译Swoole时无需再传
--with-iconv，因为Swoole会复用PHP已链接的iconv符号 - 验证：编译完Swoole后，用
php -r "echo extension_loaded('swoole') ? 'ok' : 'fail';"，再跑php --ri swoole | grep iconv看是否显示iconv支持
最容易被忽略的是：libiconv路径一旦指定，就必须贯穿整个工具链——从PHP编译开始，到Swoole编译，再到运行时ldconfig缓存，三者路径必须一致，差一个/都可能静默失败。
