解决 PHP 7.4 在安装时因 OpenSSL 冲突导致的构建失败问题

在使用 phpbrew 安装 PHP 7.4 版本时，可能会遇到与 OpenSSL 版本相关的编译错误，导致安装失败。这通常是由于系统默认的 OpenSSL 版本与 PHP 7.4 兼容性不佳引起的。以下提供一种解决方案，通过指定正确的 OpenSSL 环境变量来解决此问题。

解决方案

该方案的核心在于明确指定 PHP 编译时使用的 OpenSSL 头文件和库文件路径，避免与系统默认的 OpenSSL 版本产生冲突。

1. 查找 OpenSSL 的安装路径：

   立即学习“PHP免费学习笔记（深入）”；

   首先，需要确定系统中 OpenSSL 的安装路径。通常情况下，OpenSSL 安装在 /usr/local/opt/openssl@版本号/ 目录下。例如，如果安装的是 OpenSSL 1.1 版本，路径可能为 /usr/local/opt/openssl@1.1/。

   可以使用以下命令来查找 OpenSSL 的安装路径：

   brew info openssl

   该命令会显示 OpenSSL 的详细信息，包括安装路径。

2. 设置 OpenSSL 环境变量：

   找到 OpenSSL 的安装路径后，需要设置 OPENSSL_CFLAGS 和 OPENSSL_LIBS 环境变量，指向正确的头文件和库文件。

   export OPENSSL_CFLAGS="-I/usr/local/opt/openssl@1.1/include"
   export OPENSSL_LIBS="-L/usr/local/opt/openssl@1.1/lib -lcrypto -lssl"

   将上述命令中的 /usr/local/opt/openssl@1.1/ 替换为实际的 OpenSSL 安装路径。

3. 使用 phpbrew 安装 PHP 7.4：

   设置好 OpenSSL 环境变量后，就可以使用 phpbrew 安装 PHP 7.4 了。

   phpbrew install 7.4.25 +default

   +default 选项表示使用默认的扩展和配置。可以根据需要添加其他扩展选项。

示例

假设 OpenSSL 1.1 安装在 /usr/local/opt/openssl@1.1/ 目录下，则完整的安装命令如下：

export OPENSSL_CFLAGS="-I/usr/local/opt/openssl@1.1/include"
export OPENSSL_LIBS="-L/usr/local/opt/openssl@1.1/lib -lcrypto -lssl"
phpbrew install 7.4.25 +default

注意事项

• OpenSSL 版本： 确保使用的 OpenSSL 版本与 PHP 7.4 兼容。通常建议使用 OpenSSL 1.1 版本。
• 移除冲突版本： 如果系统中安装了多个 OpenSSL 版本，可能会导致冲突。建议先移除不兼容的版本，再进行安装。
• 环境变量持久化： 上述环境变量设置仅在当前 shell 会话有效。如果希望永久生效，可以将这些命令添加到 ~/.bashrc 或 ~/.zshrc 文件中。
• 构建日志： 如果安装过程中仍然出现错误，请仔细查看构建日志，根据错误信息进行排查。

总结

通过设置正确的 OpenSSL 环境变量，可以有效解决 PHP 7.4 在安装时因 OpenSSL 冲突导致的构建失败问题。该方案简单易行，能够帮助开发者顺利安装 PHP 7.4，并正常进行开发工作。