PHP报错 stream_socket_enable_crypto(): SSL operation failed with code 1 的排查与修复
本文目录
故障现象与原因
PHP程序连接SMTP邮件服务器时,出现以下错误:
stream_socket_enable_crypto(): SSL operation failed with code 1
这条信息表示TLS握手失败,不能仅凭它确定原因,应继续查看后面的OpenSSL错误详情。如果同时出现 certificate verify failed,再重点检查证书信任链、CA证书路径、服务器证书和系统时间。
本次故障中,目标服务器并非使用自签名证书,最终定位到本机 /etc/ssl/certs/ 中的CA证书文件损坏,修复系统CA证书后恢复正常。以下命令适用于Ubuntu、Debian等使用 ca-certificates 软件包的系统。
一、重装CA证书并重建信任库
ca-certificates 软件包提供系统信任的CA证书。先重装软件包,再重新生成证书链接和证书集合文件:
sudo apt-get update
sudo apt-get install --reinstall ca-certificates
sudo update-ca-certificates --fresh
--fresh 会清理 /etc/ssl/certs/ 中的证书符号链接并重新生成。无需直接删除整个目录,以免误删手动维护的文件。
如果系统使用企业内部CA,应确认对应证书仍保存在 /usr/local/share/ca-certificates/ 等受管理的位置。该目录中的本地CA证书应采用PEM格式,并使用 .crt 扩展名。
参考:Ubuntu:update-ca-certificates命令说明。
二、检查PHP实际使用的CA路径
如果系统证书修复后仍然报错,检查PHP加载的配置文件和证书搜索路径:
php --ini
php -r 'print_r(openssl_get_cert_locations());'
重点查看 ini_cafile、ini_capath,以及默认路径是否指向有效文件或目录。配置项为空不一定异常,PHP也可能使用OpenSSL默认的证书路径。
如果PHP配置了失效的自定义路径,可在实际生效的 php.ini 中修正。Ubuntu、Debian常见配置如下,填写前应确认对应路径存在且PHP进程可读:
openssl.cafile = /etc/ssl/certs/ca-certificates.crt
openssl.capath = /etc/ssl/certs
注意:命令行PHP与PHP-FPM可能加载不同的 php.ini。网页应用应核对PHP-FPM实际使用的配置;修改后重新加载对应服务。长期运行的队列进程也应重新启动,再重试发送邮件。
参考:PHP:openssl_get_cert_locations()、PHP OpenSSL运行时配置。
三、检查邮件服务器的TLS连接
将下列示例中的 smtp.example.com 替换为实际邮件服务器域名,并按服务商要求选择端口和加密方式。
587端口:STARTTLS
openssl s_client \
-connect smtp.example.com:587 \
-starttls smtp \
-servername smtp.example.com \
-verify_hostname smtp.example.com \
-verify_return_error \
-CAfile /etc/ssl/certs/ca-certificates.crt
465端口:隐式TLS
openssl s_client \
-connect smtp.example.com:465 \
-servername smtp.example.com \
-verify_hostname smtp.example.com \
-verify_return_error \
-CAfile /etc/ssl/certs/ca-certificates.crt
检查输出中的证书验证结果和错误信息。连接成功后可按Ctrl+C退出。该测试用于检查TLS连接和证书验证,不代表SMTP账号认证或邮件投递一定成功。
- 证书过期或尚未生效:检查服务器证书有效期及本机时间。
- 主机名不匹配:使用邮件服务商提供的SMTP域名,确认证书包含该域名。
- 无法找到颁发者证书:检查本机CA信任库,也要排查服务端是否缺少中间证书。
- TLS连接正常,但PHP仍失败:继续检查PHP运行环境、应用自定义CA路径,以及端口和加密方式是否一致。
不要通过关闭证书验证解决
在邮件配置中关闭 verify_peer、verify_peer_name 等验证选项,可能让连接暂时通过,但会失去对服务器身份的有效校验。应修复CA信任库、证书链或连接配置,保持证书验证开启。

