com doc/zh: Close php/doc-zh#14: reference/openssl/configure.xml

Commit: f7a8f229ac78b1aa5f57e4eda98211324bcb6508 Author: duanxiaoqiang <chrisdowson@qq.com> Fri, 5 Feb 2021 18:13:24 +0800 Committer: daijie <daijie@php.net> Fri, 5 Feb 2021 19:01:35 +0800 Parents: 185e525c76d155fed1a21accaa517061f97eccb9 Branches: master Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=f7a8f229ac78b1aa5f57e4eda98211324bcb6508 Log: Close php/doc-zh#14 Bugs: https://bugs.php.net/14 Changed paths: M reference/openssl/configure.xml Diff: diff --git a/reference/openssl/configure.xml b/reference/openssl/configure.xml index ee0f872a..da2aa1fa 100644 --- a/reference/openssl/configure.xml +++ b/reference/openssl/configure.xml @@ -1,22 +1,26 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: duanxiaoqiang Status: ready --> +<!-- EN-Revision: 9e4c917c09b4eed089d61074189ef81934a9dd23 Maintainer: duanxiaoqiang Status: ready --> <!-- Reviewed: no --> <section xml:id="openssl.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; <para> - 要使用 PHP 的 OpenSSL 支持，你应该使用<option role="configure">--with-openssl[=DIR]</option>参数来编译PHP. + 要使用 PHP 的 OpenSSL 支持，你应该使用<option role="configure">--with-openssl[=DIR]</option>参数来编译 PHP。 </para> <para> - OpenSSL 库还在运行时对正常操作有额外的要求。最明显的是，OpenSSL需要访问随机或伪随机数生成器; 在大多数 Unix 和类 Unix 平台上(包括linux),意味着它必须要访问 + OpenSSL 库还在运行时对正常操作有额外的要求。最明显的是，OpenSSL 需要访问随机或伪随机数生成器； 在大多数 Unix 和类 Unix 平台上(包括linux)，意味着它必须要访问 <literal>/dev/urandom</literal> 或者 <literal>/dev/random</literal> 设备。 </para> + <para> + 自 PHP 5.6.3起，<option role="configure">--with-system-ciphers</option> 配置选项可用于设置 PHP 使用系统密码列表，而不是硬编码。 + </para> <note> <title> Win32 平台的用户请注意</title> <para> &ext.windows.path.dll; - <filename>libeay32.dll</filename> + <filename>libeay32.dll</filename>， + 或者，自 OpenSSL 1.1起，为<filename>libcrypto-*.dll</filename> </para> <para> 此外，如果打算使用密钥生成和证书签名功能，你需要在你的系统上安装一个可用的 <filename>openssl.cnf</filename> 文件。 @@ -35,15 +39,48 @@ </simpara> </listitem> <listitem> - <simpara>假设<filename>openssl.cnf</filename> 文件将会在 openssl DLL 被编译时配置的默认证书区域被找到。这通常意味着默认的文件名是 <filename>c:\usr\local\ssl\openssl.cnf</filename>. + <simpara>假设<filename>openssl.cnf</filename> 文件将会在 openssl DLL 被编译时配置的默认证书区域被找到。这通常意味着默认的文件名是 <filename>C:\Program Files\Common Files\SSL\openssl.cnf</filename>(x64) + 或者<filename>C:\Program Files (x86)\Common Files\SSL\openssl.cnf</filename> (x86)，而PHP 7.4.0之前，则是<filename>C:\usr\local\ssl\openssl.cnf</filename>。 </simpara> </listitem> </itemizedlist> </para> <simpara> - 在你的安装过程中，你需要决定是否将配置文件安装在<filename>c:\usr\local\ssl\openssl.cnf</filename> 或者使用环境变量(可能是基于每个虚拟主机的基础)来定位配置文件安装到其他地方。注意，可以使用引入配置文件的函数中的 <parameter>configargs</parameter> 参数来覆盖脚本中的默认路径。 + 在你的安装过程中，你需要决定是否将配置文件安装在默认路径或者使用环境变量(可能是基于每个虚拟主机的基础)来定位配置文件安装到其他地方。注意，可以使用引入配置文件的函数中的 <parameter>configargs</parameter> 参数来覆盖脚本中的默认路径。 </simpara> + <caution> + <simpara> + 确保无权限的用户无法修改 <filename>openssl.cnf</filename>文件。 + </simpara> + </caution> </note> + + <simplesect role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>7.4.0</entry> + <entry> + OpenSSL 默认配置文件的路径已经从 <filename>C:\usr\local\ssl</filename> + 分别改至 <filename>C:\Program Files\Common Files\SSL</filename> 和 + <filename>C:\Program Files (x86)\Common Files\SSL</filename>。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </simplesect> + </section> <!-- Keep this comment at the end of the file