根本原因是PHP容器中OpenSSL扩展未启用或加载失败；需验证php -m | grep openssl、检查Dockerfile是否RUN docker-php-ext-enable openssl、避免volumes覆盖conf.d目录，并确认Alpine镜像OpenSSL版本兼容性。
PHP容器中 openssl_encrypt 报错“Unknown cipher”
根本原因不是算法不支持，而是容器内 PHP 编译时未启用 OpenSSL 扩展，或启用但未加载。Docker 默认镜像（如 php:8.2-cli）虽含 OpenSSL 库，但扩展默认未开启。
验证方式：进容器执行 php -m | grep openssl，无输出即未启用；或运行 php -r "print_r(openssl_get_cipher_methods());" 报 Fatal error: Uncaught Error: Call to undefined function openssl_get_cipher_methods()。
- Alpine 镜像需额外安装
openssl系统包和php82-opcache（或其他对应版本）扩展包 - Debian/Ubuntu 基础镜像需确保
libssl-dev在构建阶段已安装，且Dockerfile中显式启用了扩展：RUN docker-php-ext-enable openssl - 若用
php.ini手动配置，确认路径正确（/usr/local/etc/php/conf.d/docker-php-ext-openssl.ini），且内容为extension=openssl（不能带.so后缀）
容器内 openssl_encrypt 返回空或乱码
常见于密钥/IV 长度不匹配加密算法要求。例如 AES-128-CBC 要求密钥 16 字节、IV 16 字节；AES-256-CBC 则需密钥 32 字节。PHP 不会自动补位或截断，传入错误长度会静默失败或返回空字符串。
典型误操作：用 md5($key) 当密钥——虽然结果是 32 字符，但它是十六进制字符串（32 字节），实际二进制长度是 16 字节，易与 AES-256 混淆。
立即学习“PHP免费学习笔记（深入）”；
- 用
mb_strlen($key, '8bit')或strlen($key)检查原始字节长度，而非字符数 - 推荐用
openssl_random_pseudo_bytes()生成合规密钥：$key = openssl_random_pseudo_bytes(32);（AES-256） - IV 必须每次加密随机生成，且与加密结果一起保存（通常 base64 编码后拼接）：
$iv = openssl_random_pseudo_bytes(16); - 注意
openssl_encrypt第五个参数（$options）：生产环境应设为OPENSSL_RAW_DATA，避免 Base64 编码嵌套导致解密失败
Docker Compose 中 PHP 扩展路径被覆盖
当通过 volumes 挂载自定义 php.ini 或 conf.d 文件时，容易覆盖掉 Docker 官方镜像预置的扩展加载配置。尤其挂载整个 /usr/local/etc/php/conf.d/ 目录时，原生的 docker-php-ext-openssl.ini 会被清空或失效。
现象：本地 php -m 显示 openssl，容器内却消失；或日志出现 PHP Warning: Module 'openssl' already loaded（说明重复加载或冲突）。
- 避免挂载整个
conf.d/目录，改用单文件挂载：./my-openssl.ini:/usr/local/etc/php/conf.d/my-openssl.ini:ro - 若必须覆盖默认配置，先进容器查清已有文件：
ls /usr/local/etc/php/conf.d/，再在宿主机保留对应文件或合并内容 - 使用
php_ini_scan_dir确认扫描路径是否被修改：php -i | grep "Scan this dir for additional .ini files" - 重启容器后务必执行
php -m | grep openssl和php --ri openssl双重验证
Alpine 镜像下 OpenSSL 版本过低导致加密失败
部分 Alpine 小版本（如 alpine:3.18）自带 OpenSSL 3.0+，而 PHP 扩展若编译自旧版头文件，可能无法识别新算法（如 aes-256-gcm），调用时返回 false 且无明确报错。
更隐蔽的问题是：相同代码在 Debian 镜像正常，在 Alpine 下失败，容易误判为 PHP 配置问题。
- 检查 OpenSSL 版本：
openssl version -v，PHP 扩展绑定版本：php --ri openssl | grep "OpenSSL Library Version" - 优先使用官方 PHP Alpine 镜像（如
php:8.2-cli-alpine），它已适配对应 OpenSSL - 避免在 Alpine 中手动
apk add openssl升级系统库，可能导致 ABI 不兼容 - 若必须用 GCM 模式，确认 PHP ≥ 7.1 且 OpenSSL ≥ 1.1.0；Alpine 3.16+ 一般满足，但需验证扩展是否启用 AEAD 支持：
var_dump(in_array('aes-256-gcm', openssl_get_cipher_methods()));
php -m 和 php --ri openssl 输出，比直接看业务代码更高效。 
