Skip to content

Commit 6d3abf2

Browse files
mumumumumumu
committed
[reference/openssl] sync with en
1 parent 41333f0 commit 6d3abf2

File tree

6 files changed

+538
-72
lines changed

6 files changed

+538
-72
lines changed

‎reference/openssl/constants.xml‎

Lines changed: 87 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 434366e9284206b3b073a49bddf7c42e85427aa0 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 3b06ef4bb06db8cf2cd8ea8470287f7f43ef9e71 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<appendix xml:id="openssl.constants" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.constants;
@@ -140,53 +140,101 @@
140140

141141
<section xml:id="openssl.key-types">
142142
<title>キーの種類</title>
143-
<variablelist>
144-
<varlistentry xml:id="constant.openssl-keytype-rsa">
145-
<term>
146-
<constant>OPENSSL_KEYTYPE_RSA</constant>
147-
(<type>int</type>)
148-
</term>
149-
<listitem>
143+
<variablelist>
144+
<varlistentry xml:id="constant.openssl-keytype-rsa">
145+
<term>
146+
<constant>OPENSSL_KEYTYPE_RSA</constant>
147+
(<type>int</type>)
148+
</term>
149+
<listitem>
150150
<simpara>
151-
151+
RSA 鍵タイプ
152152
</simpara>
153-
</listitem>
154-
</varlistentry>
155-
<varlistentry xml:id="constant.openssl-keytype-dsa">
156-
<term>
157-
<constant>OPENSSL_KEYTYPE_DSA</constant>
158-
(<type>int</type>)
159-
</term>
160-
<listitem>
161-
<simpara>
162-
153+
</listitem>
154+
</varlistentry>
155+
<varlistentry xml:id="constant.openssl-keytype-dsa">
156+
<term>
157+
<constant>OPENSSL_KEYTYPE_DSA</constant>
158+
(<type>int</type>)
159+
</term>
160+
<listitem>
161+
<simpara>
162+
DSA 鍵タイプ
163163
</simpara>
164-
</listitem>
165-
</varlistentry>
166-
<varlistentry xml:id="constant.openssl-keytype-dh">
167-
<term>
164+
</listitem>
165+
</varlistentry>
166+
<varlistentry xml:id="constant.openssl-keytype-dh">
167+
<term>
168168
<constant>OPENSSL_KEYTYPE_DH</constant>
169169
(<type>int</type>)
170-
</term>
171-
<listitem>
172-
<simpara>
173-
174-
</simpara>
175-
</listitem>
176-
</varlistentry>
177-
<varlistentry xml:id="constant.openssl-keytype-ec">
178-
<term>
179-
<constant>OPENSSL_KEYTYPE_EC</constant>
180-
(<type>int</type>)
181-
</term>
170+
</term>
182171
<listitem>
183172
<simpara>
184-
この定数が使えるのは、PHP をコンパイルする際に OpenSSL 0.9.8 以降を使ったときだけです。
173+
DH (Diffie-Hellman) 鍵タイプ
185174
</simpara>
186175
</listitem>
187-
</varlistentry>
188-
</variablelist>
189-
</section>
176+
</varlistentry>
177+
<varlistentry xml:id="constant.openssl-keytype-ec">
178+
<term>
179+
<constant>OPENSSL_KEYTYPE_EC</constant>
180+
(<type>int</type>)
181+
</term>
182+
<listitem>
183+
<simpara>
184+
Elliptic curve (EC) 鍵タイプ
185+
</simpara>
186+
</listitem>
187+
</varlistentry>
188+
<varlistentry xml:id="constant.openssl-keytype-x25519">
189+
<term>
190+
<constant>OPENSSL_KEYTYPE_X25519</constant>
191+
(<type>int</type>)
192+
</term>
193+
<listitem>
194+
<simpara>
195+
X25519 curve 鍵タイプ。
196+
この定数が使えるのは、PHP をコンパイルする際に OpenSSL 3.0以降を使ったときだけです。
197+
</simpara>
198+
</listitem>
199+
</varlistentry>
200+
<varlistentry xml:id="constant.openssl-keytype-ed25519">
201+
<term>
202+
<constant>OPENSSL_KEYTYPE_ED25519</constant>
203+
(<type>int</type>)
204+
</term>
205+
<listitem>
206+
<simpara>
207+
Ed25519 curve 鍵タイプ。
208+
この定数が使えるのは、PHP をコンパイルする際に OpenSSL 3.0以降を使ったときだけです。
209+
</simpara>
210+
</listitem>
211+
</varlistentry>
212+
<varlistentry xml:id="constant.openssl-keytype-x448">
213+
<term>
214+
<constant>OPENSSL_KEYTYPE_X448</constant>
215+
(<type>int</type>)
216+
</term>
217+
<listitem>
218+
<simpara>
219+
X448 curve 鍵タイプ。
220+
この定数が使えるのは、PHP をコンパイルする際に OpenSSL 3.0以降を使ったときだけです。
221+
</simpara>
222+
</listitem>
223+
</varlistentry>
224+
<varlistentry xml:id="constant.openssl-keytype-ed448">
225+
<term>
226+
<constant>OPENSSL_KEYTYPE_ED448</constant>
227+
(<type>int</type>)
228+
</term>
229+
<listitem>
230+
<simpara>
231+
Ed448 curve 鍵タイプ。
232+
この定数が使えるのは、PHP をコンパイルする際に OpenSSL 3.0以降を使ったときだけです。
233+
</simpara>
234+
</listitem>
235+
</varlistentry>
236+
</variablelist>
237+
</section>
190238

191239
<section xml:id="openssl.pkcs7.flags">
192240
<title><acronym>PKCS7</acronym> フラグ/定数</title>

‎reference/openssl/functions/openssl-free-key.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi -->
55
<refentry xml:id="function.openssl-free-key" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -15,6 +15,7 @@
1515
<refsect1 role="description">
1616
&reftitle.description;
1717
<methodsynopsis>
18+
<modifier role="attribute">#[\Deprecated]</modifier>
1819
<type>void</type><methodname>openssl_free_key</methodname>
1920
<methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
2021
</methodsynopsis>

‎reference/openssl/functions/openssl-pkey-free.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: takagi Status: ready -->
44
<refentry xml:id="function.openssl-pkey-free" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>openssl_pkey_free</refname>
@@ -14,6 +14,7 @@
1414
<refsect1 role="description">
1515
&reftitle.description;
1616
<methodsynopsis>
17+
<modifier role="attribute">#[\Deprecated]</modifier>
1718
<type>void</type><methodname>openssl_pkey_free</methodname>
1819
<methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
1920
</methodsynopsis>

‎reference/openssl/functions/openssl-pkey-get-details.xml‎

Lines changed: 35 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 0e80601cabf499c7db372149916b5cb3e2740f1b Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 3b06ef4bb06db8cf2cd8ea8470287f7f43ef9e71 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="function.openssl-pkey-get-details" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -42,10 +42,15 @@
4242
返される配列のキーは <literal>bits</literal> (ビット数)、
4343
<literal>key</literal> (公開鍵を表す文字列) および
4444
<literal>type</literal> (キーの種類。
45-
<constant>OPENSSL_KEYTYPE_RSA</constant>、
46-
<constant>OPENSSL_KEYTYPE_DSA</constant>、
47-
<constant>OPENSSL_KEYTYPE_DH</constant>、
48-
<constant>OPENSSL_KEYTYPE_EC</constant> のいずれか。あるいは不明な場合は -1)
45+
<constant>OPENSSL_KEYTYPE_RSA</constant>,
46+
<constant>OPENSSL_KEYTYPE_DSA</constant>,
47+
<constant>OPENSSL_KEYTYPE_DH</constant>,
48+
<constant>OPENSSL_KEYTYPE_EC</constant>,
49+
<constant>OPENSSL_KEYTYPE_X25519</constant>,
50+
<constant>OPENSSL_KEYTYPE_ED25519</constant>,
51+
<constant>OPENSSL_KEYTYPE_X448</constant>,
52+
<constant>OPENSSL_KEYTYPE_ED448</constant> のいずれか。
53+
あるいは不明な場合は <literal>-1</literal>)
4954
となります。
5055
</para>
5156
<para>
@@ -62,7 +67,7 @@
6267
<tgroup cols="2">
6368
<thead>
6469
<row>
65-
<entry>キー</entry>
70+
<entry>Key</entry>
6671
<entry>&Description;</entry>
6772
</row>
6873
</thead>
@@ -112,7 +117,7 @@
112117
<tgroup cols="2">
113118
<thead>
114119
<row>
115-
<entry>キー</entry>
120+
<entry>Key</entry>
116121
<entry>&Description;</entry>
117122
</row>
118123
</thead>
@@ -150,7 +155,7 @@
150155
<tgroup cols="2">
151156
<thead>
152157
<row>
153-
<entry>キー</entry>
158+
<entry>Key</entry>
154159
<entry>&Description;</entry>
155160
</row>
156161
</thead>
@@ -177,8 +182,15 @@
177182
</listitem>
178183
<listitem>
179184
<simpara>
180-
<constant>OPENSSL_KEYTYPE_EC</constant> の場合は <literal>"ec"</literal>
181-
というキーがあり、キーのデータが返されます。
185+
<constant>OPENSSL_KEYTYPE_X25519</constant>,
186+
<constant>OPENSSL_KEYTYPE_ED25519</constant>,
187+
<constant>OPENSSL_KEYTYPE_X448</constant>,
188+
<constant>OPENSSL_KEYTYPE_ED448</constant> の場合は、
189+
<literal>"x25519"</literal>,
190+
<literal>"ed25519"</literal>,
191+
<literal>"x448"</literal>,
192+
<literal>"ed448"</literal> というキーがそれぞれあり、
193+
キーのデータが返されます。
182194
</simpara>
183195
<informaltable>
184196
<tgroup cols="2">
@@ -190,24 +202,12 @@
190202
</thead>
191203
<tbody>
192204
<row>
193-
<entry><literal>"curve_name"</literal></entry>
194-
<entry>name of curve, see <function>openssl_get_curve_names</function></entry>
195-
</row>
196-
<row>
197-
<entry><literal>"curve_oid"</literal></entry>
198-
<entry>ASN1 Object identifier (OID) for EC curve.</entry>
199-
</row>
200-
<row>
201-
<entry><literal>"x"</literal></entry>
202-
<entry>x coordinate (public)</entry>
203-
</row>
204-
<row>
205-
<entry><literal>"y"</literal></entry>
206-
<entry>y coordinate (public)</entry>
205+
<entry><literal>"priv_key"</literal></entry>
206+
<entry>private key</entry>
207207
</row>
208208
<row>
209-
<entry><literal>"d"</literal></entry>
210-
<entry>private key</entry>
209+
<entry><literal>"pub_key"</literal></entry>
210+
<entry>public key</entry>
211211
</row>
212212
</tbody>
213213
</tgroup>
@@ -227,6 +227,15 @@
227227
</row>
228228
</thead>
229229
<tbody>
230+
<row>
231+
<entry>8.4.0</entry>
232+
<entry>
233+
Curve25519 と Curve448 ベースの鍵のサポートが追加されました。
234+
<literal>x25519</literal>, <literal>ed25519</literal>,
235+
<literal>x448</literal>, <literal>ed448</literal>
236+
という連想配列のフィールドが新たに導入されています。
237+
</entry>
238+
</row>
230239
<row>
231240
<entry>8.0.0</entry>
232241
<entry>

0 commit comments

Comments
 (0)