在Mac M2上使用phpbrew安装PHP 7.4.33的完整指南

前言

在Mac M2芯片设备上安装旧版PHP（如7.4.33）可能会遇到各种兼容性问题。本文将详细介绍如何通过phpbrew工具成功安装PHP 7.4.33，并解决常见的编译错误。

环境准备

首先确保你的系统满足以下条件：

• Mac M1/M2芯片设备
• macOS 14.4或更高版本
• 已安装Homebrew包管理器
• 已安装phpbrew工具

依赖安装

在开始安装PHP前，需要安装必要的依赖库：

brew install pkgconfig
brew install bzip2

解决libxml2兼容性问题

Mac系统自带的libxml2版本(2.12.6)与PHP 7.4.33不兼容，需要指定使用旧版本：

export LIBXML_PREFIX=/usr/local/libxml2-2.9.14
export LIBXML_CFLAGS="-I${LIBXML_PREFIX}/include/libxml2"
export LIBXML_LIBS="-L${LIBXML_PREFIX}/lib -lxml2"

配置OpenSSL环境

PHP 7.4需要OpenSSL 1.1版本，配置相关环境变量：

export OPENSSL_PREFIX=$(brew --prefix openssl@1.1)
export OPENSSL_CFLAGS="-I${OPENSSL_PREFIX}/include"
export OPENSSL_LIBS="-L${OPENSSL_PREFIX}/lib -lcrypto -lssl"

解决链接器错误

Mac M1/M2架构下编译PHP 7.4时会出现DNS相关符号未定义错误，需要添加resolv库链接：

export LDFLAGS="-lresolv"

完整安装命令

综合以上配置，完整的安装命令如下：

rm -rf ~/.phpbrew/build/php-7.4.33
phpbrew off

export LDFLAGS="-lresolv"

export OPENSSL_PREFIX=$(brew --prefix openssl@1.1)
export OPENSSL_CFLAGS="-I${OPENSSL_PREFIX}/include"
export OPENSSL_LIBS="-L${OPENSSL_PREFIX}/lib -lcrypto -lssl"

export LIBXML_PREFIX=/usr/local/libxml2-2.9.14
export LIBXML_CFLAGS="-I${LIBXML_PREFIX}/include/libxml2"
export LIBXML_LIBS="-L${LIBXML_PREFIX}/lib -lxml2"

phpbrew install -j 12 7.4.33 +default +fpm +pdo +mysql +gd +intl -- \
    --with-openssl="shared,${OPENSSL_PREFIX}" \
    --with-libxml-dir="${LIBXML_PREFIX}" \
    --without-pcre-jit

常见问题解决

1. libxml2版本冲突：确保使用2.9.x版本而非系统自带的2.12.x版本
2. OpenSSL符号错误：正确指定OpenSSL 1.1的路径
3. DNS函数未定义：添加-lresolv链接器标志
4. PCRE JIT问题：添加--without-pcre-jit参数避免兼容性问题

总结

在Apple Silicon芯片的Mac上安装旧版PHP需要特别注意库版本兼容性和架构适配问题。通过合理配置环境变量和编译参数，可以成功构建PHP 7.4.33环境。本文提供的解决方案不仅适用于PHP 7.4.33，其思路也可应用于其他旧版PHP在ARM架构Mac上的安装。