Add caution about openssl_pkey_derive key_length parameter

* Add caution about openssl_pkey_derive key_length parameter
* Fix typo in reference/openssl/functions/openssl-pkey-derive.xml

php/doc-en@7fd8e59

Author: zonuexe

reference/openssl/functions/openssl-pkey-derive.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 7fd8e591b8b5a35eda6a0fa6cdecd2a83b195920 Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="function.openssl-pkey-derive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -51,8 +51,16 @@
     <term><parameter>key_length</parameter></term>
     <listitem>
      <para>
-      0でない場合、生成するシークレットの長さを指定します。
+      0でない場合、生成するシークレットの長さを設定しようと試みます。
      </para>
+     <caution>
+      <simpara>
+        このパラメータは期待どおりに機能しないため、使用しないでください。
+        シークレットが素数のサイズよりも長くなることはありません。
+        必要な長さが素数のサイズより小さい場合、ECDH キーの場合のみ長さを切り詰めますが、
+        DH キーの場合は失敗します。
+      </simpara>
+     </caution>
     </listitem>
    </varlistentry>
   </variablelist>