解决PHP 7.4在安装时OpenSSL编译错误

本文档旨在帮助开发者解决在使用phpbrew安装PHP 7.4时遇到的OpenSSL编译错误。该错误通常是由于OpenSSL版本不兼容导致的。我们将通过设置正确的OpenSSL环境变量来解决此问题，确保PHP 7.4能够成功编译和安装。

问题分析

在尝试使用phpbrew install 7.4安装PHP 7.4时，可能会遇到与OpenSSL相关的编译错误。错误日志通常会显示类似以下信息：

/usr/local/Cellar/openssl@3/3.0.0_1/include/openssl/rsa.h:289:29: note: passing argument to parameter 'rsa' here
RSA *rsa, int padding);
^
108 warnings and 1 error generated.
make: *** [ext/openssl/openssl.lo] Error 1

这通常意味着PHP 7.4的OpenSSL扩展与系统上安装的OpenSSL版本（例如OpenSSL 3.0）不兼容。

解决方案

解决此问题的关键在于告诉PHP编译过程使用正确的OpenSSL版本。这可以通过设置OPENSSL_CFLAGS和OPENSSL_LIBS环境变量来实现。

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

步骤 1: 查找OpenSSL安装路径

首先，需要确定系统上OpenSSL 1.1的安装路径。通常，它可能位于/usr/local/opt/openssl@1.1或类似的位置。可以使用brew info openssl@1.1命令来查找安装信息（如果使用Homebrew安装）。如果没有安装，需要先安装OpenSSL 1.1。

步骤 2: 设置环境变量

设置OPENSSL_CFLAGS和OPENSSL_LIBS环境变量，指向OpenSSL 1.1的include和lib目录。例如：

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

请根据实际的OpenSSL安装路径调整上述命令。

步骤 3: 使用phpbrew安装PHP 7.4

现在，可以使用phpbrew安装PHP 7.4，并指定所需的扩展。例如：

phpbrew install 7.4.25 +default

或者，可以将环境变量直接添加到phpbrew install命令中：

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

步骤 4: 清理构建目录 (可选)

如果之前安装失败，可能需要清理构建目录，以确保从干净的状态开始。可以使用以下命令：

phpbrew clean 7.4.25

步骤 5: 卸载OpenSSL 3.0 (如果需要)

在某些情况下，如果OpenSSL 3.0导致持续冲突，可能需要卸载它。可以使用Homebrew卸载：

brew uninstall openssl@3

注意事项

• 确保OpenSSL 1.1已正确安装，并且环境变量指向正确的路径。
• 如果仍然遇到问题，请检查phpbrew install命令的完整输出，查找任何其他错误信息。
• 如果系统中同时存在多个OpenSSL版本，请确保在编译PHP时使用正确的版本。
• 如果使用了自定义的PHP配置，请检查是否与其他OpenSSL相关的设置冲突。

总结

通过设置正确的OPENSSL_CFLAGS和OPENSSL_LIBS环境变量，可以解决在使用phpbrew安装PHP 7.4时遇到的OpenSSL编译错误。确保指向正确的OpenSSL 1.1安装路径，并清理构建目录（如果需要），然后重新运行phpbrew install命令。如果问题仍然存在，请检查完整的构建日志，查找其他错误信息。