直接编译PHP源码可彻底避开Homebrew冲突，但需先安装Xcode命令行工具、用MacPorts装openssl和icu4c，configure时显式指定路径并禁用系统冲突模块，编译后还需修复dylib依赖和php.ini路径。
直接编译 PHP 源码安装是避开 Homebrew 管理冲突最彻底的方式，但 macOS 上默认不带完整编译工具链、系统 OpenSSL 和 ICU 版本老旧、configure 参数稍有偏差就报错——这些才是实际卡住人的地方。
确认 Xcode Command Line Tools 和必要依赖已就位
macOS 不自带 make、autoconf、libtool，仅装 Xcode IDE 不够，必须显式安装命令行工具；同时系统自带的 openssl（Apple CryptoKit 封装版）和 icu4c 无法被 PHP 编译识别，必须用 MacPorts 或手动编译替代。
- 运行
xcode-select --install安装命令行工具，验证：执行clang --version和make -v应有输出 - 不要用 Homebrew 装
openssl或icu4c—— 后续 configure 会因路径混杂失败；改用 MacPorts：sudo port install openssl +universal icu +universal - MacPorts 安装后，头文件和库默认在
/opt/local/include和/opt/local/lib，这两个路径后续必须显式传给configure
configure 时必须显式指定关键路径和禁用冲突模块
PHP 源码 configure 脚本在 macOS 上默认尝试链接系统库，而 Apple 的 libiconv、libxml2、openssl 都是阉割版或符号不兼容，不指定路径必报 undefined symbol 或 library not found。
- 基础路径参数必须包含：
--with-openssl=/opt/local --with-iconv=/opt/local --with-icu-dir=/opt/local - 禁用 macOS 冲突模块：
--without-pear --disable-opcache-file --without-libzip（系统 libzip 版本太低，建议后续用 pecl 单独装 zip） - 如果需要 MySQLi，不要用
--with-mysql（已废弃），改用--with-mysqli=mysqlnd或指定mysql_config路径 - 示例片段：
./configure --prefix=/usr/local/php-dev --with-openssl=/opt/local --with-iconv=/opt/local --with-icu-dir=/opt/local --enable-fpm --enable-mbstring
编译后需手动处理 dylib 依赖和 php.ini 路径
make install 生成的二进制仍可能动态链接到 /usr/lib 下的旧库，运行时提示 Library not loaded: /usr/lib/libiconv.2.dylib 是典型症状；同时 PHP 默认找不到配置文件，php --ini 显示 “Loaded Configuration File: (none)”。
立即学习“PHP免费学习笔记（深入）”；
- 用
otool -L /usr/local/php-dev/bin/php检查依赖，若看到/usr/lib/libiconv.*或/usr/lib/libssl.*，说明 configure 时路径未生效，需重编译 - 修复方法：在 configure 前设环境变量：
export LDFLAGS="-L/opt/local/lib" CPPFLAGS="-I/opt/local/include" -
php --ini显示的 “Scan for additional .ini files in” 路径需手动创建，如/usr/local/php-dev/etc/conf.d/，再把php.ini-development复制过去并重命名为php.ini - FPM 启动前务必检查
/usr/local/php-dev/etc/php-fpm.d/www.conf中listen地址，macOS 上推荐用 socket（如listen = /usr/local/php-dev/var/run/php-fpm.sock）而非 127.0.0.1:9000，避免端口占用问题
最难缠的不是编译失败，而是运行时报错时错误信息指向错误的库路径——因为 configure 阶段没锁死 --with-xxx 路径，或者 LDFLAGS 在 make 时被覆盖。每次修改配置后，务必先 make clean 再重新 ./configure && make，否则缓存的 Makefile 会偷偷沿用旧路径。
