PHP 缺 OpenSSL 扩展需按安装方式区别处理：包管理器安装需补装对应扩展包；源码编译需加 --with-openssl 参数；Windows 检查 php_openssl.dll 存在及 php.ini 启用；Docker 中确认内置支持并统一 php.ini 路径；Mac M1/M2 需核对 Homebrew openssl 版本与 extension_dir 一致性；云环境可能禁用动态加载，需联系平台确认。
php -v 报错 extension=openssl.so 找不到
Yii2 安装时提示缺 OpenSSL，但 php -v 直接报错说找不到 openssl.so，说明 PHP 编译时没带 OpenSSL 支持，或配置里写了但文件根本不存在。
先确认 PHP 是怎么装的：是系统包管理器（如 apt/yum）、手动编译、还是用 XAMPP/MAMP/AMPPS 这类集成环境？不同来源处理方式完全不同。
- Ubuntu/Debian 上用
apt install php-openssl就行，装完会自动启用； - CentOS/RHEL 8+ 用
dnf install php-opcache php-curl php-gd php-mbstring php-xml php-zip php-opcache（php-openssl通常随核心包默认启用，不单独提供）； - 如果 PHP 是自己编译的，必须加
--with-openssl=/usr（路径按实际 OpenSSL 安装位置调整），漏掉这个参数就真没 openssl 扩展； - Windows 下检查
php.ini里有没有extension=php_openssl.dll，且该 DLL 文件确实在ext/目录下。
phpinfo() 显示 openssl 已加载但 Yii2 仍报错
这说明扩展存在且被 PHP 认可，但 Yii2 的 composer install 或运行时校验仍失败——大概率是 OpenSSL 库本身没被正确链接，或者 PHP 运行时用的不是你看到的那个配置。
常见原因有三个：
立即学习“PHP免费学习笔记（深入）”；
- CLI 和 Web 使用的
php.ini不同：运行php --ini看 CLI 加载的配置，再在浏览器打开phpinfo()页面看 Web 加载的是哪个，两者都要检查extension=openssl是否启用； - OpenSSL 版本太老：
php -r "print OPENSSL_VERSION_TEXT;"输出如果是OpenSSL 1.0.2或更低，某些新版 Composer/Yii2 组件会拒绝启动（尤其在 TLS 1.3 或证书验证场景）； -
openssl.cafile或openssl.capath配置为空或路径错误，导致 HTTPS 请求失败，Composer 安装卡在下载阶段，误判为“缺 OpenSSL”。
docker 中运行 Yii2 容器提示 openssl 扩展不可用
Docker 镜像（比如官方 php:8.1-apache）默认不启用所有扩展，即使基础镜像已编译进 openssl，也得手动开启。
在 Dockerfile 里不能只写 docker-php-ext-enable openssl，因为这个命令只对已安装的扩展生效；而 openssl 在多数 PHP 官方镜像中是“内置”而非“扩展”，不需要也不支持用 docker-php-ext-install 安装。
- 正确做法是检查
php -m | grep openssl是否输出openssl； - 若无输出，说明镜像构建时没启用，换用
php:8.1-cli或php:8.1-apache带-slim后缀的版本可能更干净； - 若已有输出但容器内 Yii2 还报错，大概率是 Composer 运行在另一个用户上下文（如 www-data），其环境变量或
php.ini路径不同，建议统一用php -c /usr/local/etc/php/php.ini -m显式指定配置再查。
Mac M1/M2 上 Homebrew 安装 PHP 后 openssl 不工作
Homebrew 的 PHP（比如 php@8.1）默认依赖 openssl@3，但 PHP 配置里写的可能是 openssl@1.1 路径，导致 extension_dir 指向错误目录，openssl.so 加载失败。
执行 brew info openssl 看当前激活的是哪个版本，再对比 php --ini 输出的配置路径里 php.ini 中的 extension_dir 值是否匹配。
- 如果
extension_dir = "/opt/homebrew/lib/php/20210902"，但openssl.so实际在/opt/homebrew/Cellar/php@8.1/8.1.27/lib/php/20210902/下，就得改php.ini； - 更稳妥的是删掉
extension=openssl行，让 PHP 自动加载内置模块（现代 PHP 8.1+ 多数情况已默认内置）； - 别信
brew reinstall php能自动修好——它不会重写你的php.ini，旧配置残留才是真问题。
最常被忽略的一点：有些云主机或 PaaS（比如阿里云轻量、腾讯云 CODING）提供的 PHP 环境，会把 OpenSSL 编译成静态模块但禁用 extension= 加载方式，此时 php -m 能看到 openssl，但 extension_loaded('openssl') 返回 false。这种环境下 Yii2 的依赖检查会直接失败，必须联系平台支持确认是否允许动态扩展加载，而不是自己折腾 ini 文件。
