如何为PHP的imap_open()函数指定自定义证书文件

方法1：直接在imap_open调用时传入证书配置（推荐，无需修改全局配置） #

PHP的imap_open函数支持通过第6个参数$params传入SSL上下文配置，你可以直接指定自定义证书路径，代码示例如下：

// 构造IMAP连接地址，注意移除/novalidate-cert参数
$mailbox = '{imap.gmail.com:993/ssl}INBOX';
// 配置SSL证书参数
$sslParams = [
    'ssl' => [
        'cafile' => '/home/imap/googleRootCA.pem',
        'verify_peer' => true,
        'verify_peer_name' => true,
    ]
];
// 调用imap_open，传入配置
$connection = imap_open($mailbox, $user, $password, 0, 0, $sslParams);

配置项说明 #

• cafile：填写你本地存储的根证书绝对路径，这里直接用你给出的/home/imap/googleRootCA.pem即可
• verify_peer：开启服务端证书验证，替换原来/novalidate-cert的关闭验证逻辑
• verify_peer_name：验证证书中的域名与实际连接的域名是否匹配，进一步提升安全性

注意事项 #

• 该配置要求PHP版本 >= 5.3.2，低于该版本的PHP不支持imap_open的$params参数
• 请确保运行PHP的进程对证书文件/home/imap/googleRootCA.pem有读取权限，否则会验证失败
• 如果你同时连接多个IMAP服务需要不同证书，直接在对应连接的$sslParams里指定不同的cafile路径即可，不会互相影响

可选全局配置（不推荐，影响所有SSL请求） #

如果你希望所有PHP的SSL请求都默认使用该证书，可以修改php.ini配置：

openssl.cafile = "/home/imap/googleRootCA.pem"

修改后重启PHP-FPM或者Web服务器即可生效，这种方式不需要在每次调用imap_open时传参数，但会影响所有用到SSL验证的PHP功能，包括curl、file_get_contents等的SSL请求。

内容的提问来源于stack exchange，提问作者temuri