Ventura 13.6.4编译PHP 8.2.16时GNU libiconv路径不被识别致报错

核心解决方案：完整指定libiconv编译参数 #

直接将Homebrew安装的libiconv的头文件路径、库文件路径及链接参数全部传入configure，强制脚本优先检测GNU版本：

PKG_CONFIG_PATH="/usr/local/opt/libiconv/lib/pkgconfig" \
CFLAGS="-I/usr/local/opt/libiconv/include" \
LDFLAGS="-L/usr/local/opt/libiconv/lib -liconv" \
./configure --with-iconv=/usr/local/opt/libiconv [你的其他编译参数，比如--enable-cgi等]

验证与排查步骤 #

• 确认libiconv安装完整性
  执行以下命令检查Homebrew的libiconv是否包含必要文件：

  brew list libiconv
  

  输出需包含/usr/local/opt/libiconv/include/iconv.h和/usr/local/opt/libiconv/lib/libiconv.dylib，否则重新安装：brew reinstall libiconv

• 手动验证GNU libiconv的errno支持
  创建测试文件test_iconv_errno.c：

  #include <iconv.h>
  #include <errno.h>
  int main() {
      iconv_t cd = iconv_open("UTF-8", "ASCII");
      if (cd == (iconv_t)-1) {
          return errno;
      }
      iconv_close(cd);
      return 0;
  }
  

  用Homebrew的libiconv编译并运行：

  gcc -I/usr/local/opt/libiconv/include -L/usr/local/opt/libiconv/lib -liconv test_iconv_errno.c -o test_iconv
  ./test_iconv
  echo $?
  

  返回0则说明libiconv本身支持errno，问题出在configure的检测逻辑。

无效原因说明 #

• PHP 8.2.16的configure脚本对libiconv的检测逻辑有更新，单独设置LDFLAGS或LIBS无法覆盖系统自带iconv的检测优先级。
• 系统whereis显示两个iconv路径是正常的：/usr/bin/iconv是系统自带版本，/usr/local/opt/libiconv/bin/iconv是Homebrew的可执行文件，但configure检测的是库文件而非可执行文件，因此必须明确指定头文件和库路径。

备选方案：通过pkg-config传递参数 #

先确认pkg-config能识别libiconv：

pkg-config --cflags libiconv
pkg-config --libs libiconv

若输出包含-I/usr/local/opt/libiconv/include和-L/usr/local/opt/libiconv/lib -liconv，直接用以下命令编译：

./configure --with-iconv=$(pkg-config --prefix libiconv) [你的其他编译参数]

内容的提问来源于stack exchange，提问作者Lasse