PHP报错“Call to undefined function openssl_encrypt()”是因OpenSSL扩展未启用：Windows需检查php.ini中extension=openssl是否生效及路径、DLL版本；Linux应通过系统包管理器安装php-openssl并重启服务；还需验证PHP与OpenSSL库版本兼容性。
PHP报错“Call to undefined function openssl_encrypt()”
这是最典型的 OpenSSL 扩展未启用现象，不是代码写错了，而是 PHP 运行时根本没加载 openssl 扩展。Windows 下常见于 php.ini 里 extension=openssl 被注释或路径不对；Linux 下则多因没装 php-opcache 之外的扩展包（比如 Ubuntu 忘装 php-xml 或 php-common 依赖，导致 php-openssl 安装失败）。
验证方式很简单：php -m | grep openssl（命令行）
或写个 phpinfo() 页面搜 “openssl” —— 如果没出现 “OpenSSL support => enabled”，就说明扩展压根没起来。
php.ini 中 extension=openssl 不生效的常见原因
Windows 用户最容易卡在这一步：看似已取消注释，但实际无效。原因包括：
-
php.ini文件不是 PHP 实际读取的那个（用php --ini确认加载路径） -
extension_dir指向错误目录（比如指向了ext子目录但实际 DLL 在上级，或路径含中文/空格未加引号） -
php_openssl.dll文件缺失或版本不匹配（PHP 8.2 需要对应 VC17 编译的 DLL，旧版 DLL 会静默失败） - Apache/Nginx 服务没重启，或 CLI 和 Web 使用的是不同
php.ini
Linux 下安装 openssl 扩展的正确操作顺序
不要直接 pecl install openssl —— PECL 不提供这个扩展，它是 PHP 源码内置模块，必须通过系统包管理器安装：
- Ubuntu/Debian：
sudo apt install php-openssl（注意不是php7.4-openssl这种带版本号的，除非你明确锁定版本） - CentOS/RHEL 8+：
sudo dnf install php-openssl - Alpine：
apk add php7-opcache不够，得加php7-openssl（注意 Alpine 的 PHP 包名带版本后缀） - 装完务必重启 Web 服务：
sudo systemctl restart apache2或sudo systemctl restart php-fpm
如果提示 “No package php-openssl available”，先运行 apt update 或检查仓库源是否启用 universe（Ubuntu）。
立即学习“PHP免费学习笔记（深入）”；
PHP 版本与 OpenSSL 库版本不兼容的典型表现
即使扩展加载成功，也可能在调用 openssl_encrypt() 时抛出 error:060800A3:digital envelope routines:EVP_CIPHER_CTX_set_key_length:invalid key length 这类底层错误。这往往不是密钥长度问题，而是 PHP 和系统 OpenSSL 库 ABI 不匹配：
- PHP 8.1+ 默认要求 OpenSSL 1.1.1 或更高；若系统是 OpenSSL 1.0.2（如 CentOS 7 默认），编译安装 PHP 时就得加
--with-openssl=/path/to/openssl11 - Docker 环境中常见：基础镜像用
php:8.2-cli但宿主机 OpenSSL 太旧，而容器内实际用的是镜像自带的库，一般没问题；但若挂载了宿主机/usr/lib就可能冲突 - 可通过
php -r "print OPENSSL_VERSION_TEXT;"查看 PHP 绑定的 OpenSSL 版本，再对比openssl version输出
这类兼容性问题不会报“函数不存在”，但加密/解密行为异常或随机失败，调试时容易误判为逻辑错误。
