PHP缺失openssl扩展会导致加密函数和HTTPS请求失败，核心是正确链接系统OpenSSL开发库并启用扩展：需安装对应系统的openssl-devel/libssl-dev包，编译时确保--enable-openssl或--with-openssl路径正确，已安装PHP则需在php.ini中启用extension=openssl（Windows为php_openssl.dll），最后用php -r验证加载与加密功能。
PHP 编译或运行时缺失 openssl 扩展，会导致 openssl_encrypt()、openssl_decrypt()、file_get_contents("https://...") 等直接报错或静默失败。核心问题不是“下载安装 OpenSSL 库”，而是让 PHP 正确链接并启用已有的 OpenSSL 支持。
确认系统是否已装 OpenSSL 开发库
PHP 编译时需依赖 OpenSSL 的头文件和静态/动态库（如 libssl-dev 或 openssl-devel），仅装 openssl 命令行工具不够。
- Ubuntu/Debian：
apt list --installed | grep ssl-dev，没结果就运行sudo apt install libssl-dev - CentOS/RHEL/Fedora：
rpm -q openssl-devel，若未安装，执行sudo yum install openssl-devel（RHEL 8+ 用dnf） - macOS（Homebrew）：
brew install openssl，然后注意后续编译时指定--with-openssl=/opt/homebrew/opt/openssl（Apple Silicon）或--with-openssl=/usr/local/opt/openssl（Intel）
编译 PHP 时启用 openssl 扩展
如果从源码编译 PHP，--enable-openssl 是默认开启的，但前提是系统有开发库且路径可被自动探测到；若探测失败，必须显式指定路径。
- 检查 configure 日志中是否出现
checking for OpenSSL support... yes和checking for OpenSSL version... >= 1.0.1 - 若失败，加参数重试：
--with-openssl=/usr（Linux 默认路径）或--with-openssl=/opt/homebrew/opt/openssl（macOS） - 不要加
--without-openssl，哪怕注释掉也要确保它没出现在 configure 命令里 - 编译后运行
php -m | grep openssl，有输出即表示扩展已加载
已安装 PHP 但 openssl 扩展未启用
常见于包管理器安装（如 apt install php）或第三方二进制包（如 XAMPP、WAMP），此时扩展可能已编译好但未在 php.ini 中启用。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php --ini查看加载的配置文件路径 - 打开对应
php.ini，搜索extension=openssl—— 若被注释（开头有分号;），删掉分号；若整行不存在，手动添加extension=openssl（PHP 7.2+ 可省略.so后缀） - Windows 用户注意：应写
extension=php_openssl.dll，且确认php_openssl.dll文件在ext/目录下 - 重启 Web 服务（
sudo systemctl restart apache2或sudo service nginx reload）或 PHP-FPM 进程
验证 openssl 功能是否真正可用
光有扩展加载不等于能用 —— 还得检查密钥格式、协议版本、密码套件是否兼容。最简验证方式：
php -r "echo extension_loaded('openssl') ? 'OK' : 'FAIL';"
更进一步测试加密能力：
php -r "\$data = 'test'; \$cipher = 'AES-128-CBC'; \$key = str_repeat('a', 16); \$iv = str_repeat('b', 16); var_dump(openssl_encrypt(\$data, \$cipher, \$key, OPENSSL_RAW_DATA, \$iv));"
- 若输出
string(16) "..."，说明基础加密通路正常 - 若报错
Call to undefined function openssl_encrypt()，说明扩展未加载成功 - 若报错
Unknown cipher，说明 PHP 版本太低（AES-128-CBC在 PHP 5.4+ 支持），或 OpenSSL 库版本过旧（如 RHEL 6 自带的 OpenSSL 1.0.1e 有部分算法限制）
最容易被忽略的是：某些精简版 PHP（如 Alpine Linux 上的 php-cli 包）默认不包含 openssl 扩展，必须额外安装 php7-openssl（Alpine）或 php-opcache（实际是元包，会拉取依赖）—— 这类场景下，php.ini 修改无效，必须先装扩展包。
