需同时设置 OPENSSL_CFLAGS 和 OPENSSL_LIBS 环境变量，并通过 PHP_BUILD_CONFIGURE_OPTS 显式启用 --with-openssl，否则编译时 OpenSSL 支持将被静默跳过。
phpenv 安装 PHP 时提示 OpenSSL 编译失败怎么办
根本原因是 php-build 在编译 PHP 时找不到 OpenSSL 头文件或库，尤其在 macOS（Homebrew）或自定义 OpenSSL 路径的 Linux 环境下高频出现。不是改 phpenv 本身，而是要提前设置好构建期环境变量。
必须同时设置两个变量，缺一不可：
-
OPENSSL_CFLAGS：告诉编译器去哪找openssl/ssl.h等头文件 -
OPENSSL_LIBS：告诉链接器去哪找libssl.so或libcrypto.dylib及其依赖参数
以 Homebrew 安装的 OpenSSL 1.1 为例（macOS 常见路径）：
export OPENSSL_CFLAGS="-I/usr/local/opt/openssl@1.1/include" export OPENSSL_LIBS="-L/usr/local/opt/openssl@1.1/lib -lcrypto -lssl"
Linux 用户若用 apt 安装了 libssl-dev，通常无需手动设——但若用源码编译 OpenSSL 到 /opt/openssl，就得对应改成：
export OPENSSL_CFLAGS="-I/opt/openssl/include" export OPENSSL_LIBS="-L/opt/openssl/lib -lcrypto -lssl"
这些变量只需在执行 phpenv install 前生效，建议临时 export，避免污染全局环境。
如何让 phpenv 使用自定义 OpenSSL 编译选项
仅设 OPENSSL_CFLAGS 和 OPENSSL_LIBS 不够——PHP configure 脚本默认不自动启用 OpenSSL 支持，必须显式传参。这时要用 PHP_BUILD_CONFIGURE_OPTS。
这个变量是 php-build 插件读取的，用于拼接到 configure 命令末尾。常见组合写法：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl --with-curl"
注意：--with-openssl 本身不指定路径，它依赖前面的 OPENSSL_CFLAGS 和 OPENSSL_LIBS 才能定位正确版本。如果漏掉任一环节，configure 可能静默跳过 OpenSSL，导致后续 php -m | grep openssl 查不到模块。
实操建议：
- 把这两个 export 合并写进 shell 配置（如
~/.zshrc），但加注释说明“仅用于编译” - 安装完某版本后，立刻验证：
phpenv local 8.3.13 && php -r "print_r(openssl_get_cipher_methods());" - 若报错
Call to undefined function openssl_get_cipher_methods()，说明编译未生效，回退检查两个环境变量是否拼写错误（比如写成OPEN_SSL_CFLAGS）
phpenv 本身不提供证书生成工具，别混淆
phpenv 是版本管理器，不是 OpenSSL 封装器。它不带 openssl 命令，也不生成证书。所谓“phpenv 证书工具”是误传——实际是你系统已装的 openssl 命令，和 phpenv 无关。
如果你需要为 Nginx/Apache 生成本地 HTTPS 证书，流程完全独立：
- 确保系统 PATH 中有
openssl（运行which openssl验证） - Windows 下需手动配置
OPENSSL_HOME和Path，否则openssl命令不可用 - 生成步骤（如私钥+CSR+crt）和路径、密码处理逻辑，与
phpenv无任何调用关系
唯一相关点：当你的 PHP 项目需要调用 openssl_pkey_new() 等函数时，才依赖前面编译阶段是否启用了 OpenSSL 支持。证书文件本身只是磁盘上的 .key 和 .crt，PHP 运行时不关心它们怎么来的。
容易被忽略的关键细节
最常卡住的地方不是命令写错，而是变量作用域和 shell 初始化顺序：
-
OPENSSL_*和PHP_BUILD_CONFIGURE_OPTS必须在phpenv install执行前 export，且不能放在eval "$(phpenv init -)"之后的同一行里（shell 解析顺序问题） - 使用
phpenv shell或phpenv local切换版本后，不会重新触发编译；它们只修改$PATH指向已编译好的二进制 - Ubuntu/Debian 用户若跳过
sudo apt install libssl-dev，即使设置了OPENSSL_CFLAGS，configure 仍可能因缺失pkg-config openssl而 fallback 到不启用 OpenSSL
一句话：OpenSSL 不是 phpenv 的插件，它是 PHP 编译期的外部依赖。所有配置都是为了喂给 ./configure，而不是运行时的 phpenv 命令本身。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
