安装/配置

目录

需求

要使用 Open SSL 函数,你必须安装» OpenSSL 库。 PHP 5 要求OpenSSL >= 0.9.6。 然而PHP5后续版本会有些编译上的问题,所以最好是使用OpenSSL >= 0.9.8(PHP7要求的最低版本) 。 其他版本(PHP >= 7.1.0) 要求 OpenSSL >= 1.0.1.

Warning

强烈建议你使用最新的OpenSSL版本,否则你的web服务器很容易受到攻击。

安装

要使用 PHP 的 OpenSSL 支持,你应该使用**--with-openssl[=DIR]**参数来编译PHP.

OpenSSL 库还在运行时对正常操作有额外的要求。最明显的是,OpenSSL需要访问随机或伪随机数生成器; 在大多数 Unix 和类 Unix 平台上(包括linux),意味着它必须要访问 /dev/urandom 或者 /dev/random 设备。

Note: Win32 平台的用户请注意

为了使此扩展生效, DLL 文件必须能在 Windows 系统的 PATH 指示的路径下找到。如何操作的信息,请参见题为“如何在 Windows 中将 PHP 目录加到 PATH 中”的FAQ。虽然将 DLL 文件从 PHP 文件夹复制到 Windows 系统目录也行,但不建议这样做。 此扩展需要下列文件在 PATH 路径中: libeay32.dll

此外,如果打算使用密钥生成和证书签名功能,你需要在你的系统上安装一个可用的 openssl.cnf 文件。 在我们的 win32 二进制发行版本中,我们已经包含了一个示例配置文件,在 extras/openssl 文件夹中。

PHP 将会使用如下逻辑搜索 openssl.cnf 文件:

  • 如果 OPENSSL_CONF 环境变量设置了,该变量将会被当作配置文件的路径(含文件名)。
  • 如果 SSLEAY_CONF 环境变量设置了,该变量将会被当作配置文件的路径(含文件名)。
  • 假设openssl.cnf 文件将会在 openssl DLL 被编译时配置的默认证书区域被找到。这通常意味着默认的文件名是 c:\usr\local\ssl\openssl.cnf.
在你的安装过程中,你需要决定是否将配置文件安装在`c:\usr\local\ssl\openssl.cnf` 或者使用环境变量(可能是基于每个虚拟主机的基础)来定位配置文件安装到其他地方。注意,可以使用引入配置文件的函数中的 `configargs` 参数来覆盖脚本中的默认路径。

运行时配置

这些函数的行为受 php.ini 中的设置影响。

名字默认可修改范围Changelog
openssl.cafile""PHP_INI_PERDIR自PHP 5.6.0起可用。
openssl.capath""PHP_INI_PERDIR自PHP 5.6.0起可用。

有关 PHP_INI_* 样式的更多详情与定义,见 配置可被设定范围

这是配置指令的简短说明。

openssl.cafile string
本地文件系统上证书颁发机构文件的位置, 被用来和对等校验上下文选项一起校验远程对等方的身份。

openssl.capath string
如果没有制定证书颁发机构文件或者证书找不到,将在由capath指向的目录下搜索一个合适的证书。capath 必须是一个正确的已被散列的证书目录。

参见 SSL stream context 选项。

资源类型

在OpenSSL模块中有三种资源类型。第一种是一个 pkey(公钥或私钥)标识符,第二种是一个X509证书标识符,第三种是 CSR (证书签名请求) 标识符。