Skip to content

Commit 1bb4baf

Browse files
authored
[PHP 8.4] Sodium関数追加分の翻訳 (php#178)
* Sodium関数追加分の翻訳 * revision修正 * 不要な翻訳の削除
1 parent c5c503a commit 1bb4baf

7 files changed

+599
-1
lines changed

reference/sodium/constants.xml

Lines changed: 89 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: 5671f3fe71c2b96d129896e1f6ed73cf081e5246 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 01cb7d495c454cea3828d75e181241b6ac3f15ae Maintainer: mumumu Status: ready -->
44

55
<appendix xml:id="sodium.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
&reftitle.constants;
@@ -77,6 +77,94 @@
7777
</simpara>
7878
</listitem>
7979
</varlistentry>
80+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-keybytes">
81+
<term>
82+
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_KEYBYTES</constant>
83+
(<type>int</type>)
84+
</term>
85+
<listitem>
86+
<simpara>
87+
PHP 8.4.0 以降で利用可能です。
88+
</simpara>
89+
</listitem>
90+
</varlistentry>
91+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-nsecbytes">
92+
<term>
93+
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_NSECBYTES</constant>
94+
(<type>int</type>)
95+
</term>
96+
<listitem>
97+
<simpara>
98+
PHP 8.4.0 以降で利用可能です。
99+
</simpara>
100+
</listitem>
101+
</varlistentry>
102+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-npubbytes">
103+
<term>
104+
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_NPUBBYTES</constant>
105+
(<type>int</type>)
106+
</term>
107+
<listitem>
108+
<simpara>
109+
PHP 8.4.0 以降で利用可能です。
110+
</simpara>
111+
</listitem>
112+
</varlistentry>
113+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-abytes">
114+
<term>
115+
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_ABYTES</constant>
116+
(<type>int</type>)
117+
</term>
118+
<listitem>
119+
<simpara>
120+
PHP 8.4.0 以降で利用可能です。
121+
</simpara>
122+
</listitem>
123+
</varlistentry>
124+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-keybytes">
125+
<term>
126+
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_KEYBYTES</constant>
127+
(<type>int</type>)
128+
</term>
129+
<listitem>
130+
<simpara>
131+
Available as of PHP 8.4.0.
132+
</simpara>
133+
</listitem>
134+
</varlistentry>
135+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-nsecbytes">
136+
<term>
137+
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_NSECBYTES</constant>
138+
(<type>int</type>)
139+
</term>
140+
<listitem>
141+
<simpara>
142+
PHP 8.4.0 以降で利用可能です。
143+
</simpara>
144+
</listitem>
145+
</varlistentry>
146+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-npubbytes">
147+
<term>
148+
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_NPUBBYTES</constant>
149+
(<type>int</type>)
150+
</term>
151+
<listitem>
152+
<simpara>
153+
PHP 8.4.0 以降で利用可能です。
154+
</simpara>
155+
</listitem>
156+
</varlistentry>
157+
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-abytes">
158+
<term>
159+
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_ABYTES</constant>
160+
(<type>int</type>)
161+
</term>
162+
<listitem>
163+
<simpara>
164+
PHP 8.4.0 以降で利用可能です。
165+
</simpara>
166+
</listitem>
167+
</varlistentry>
80168
<varlistentry xml:id="constant.sodium-crypto-aead-aes256gcm-keybytes">
81169
<term>
82170
<constant>SODIUM_CRYPTO_AEAD_AES256GCM_KEYBYTES</constant>
Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 01cb7d495c454cea3828d75e181241b6ac3f15ae Maintainer: Ippey Status: ready -->
4+
<refentry xml:id="function.sodium-crypto-aead-aegis128l-decrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>sodium_crypto_aead_aegis128l_decrypt</refname>
7+
<refpurpose>AEGIS-128L を用いてメッセージを検証し、複合する</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type class="union"><type>string</type><type>false</type></type><methodname>sodium_crypto_aead_aegis128l_decrypt</methodname>
14+
<methodparam><type>string</type><parameter>ciphertext</parameter></methodparam>
15+
<methodparam><type>string</type><parameter>additional_data</parameter></methodparam>
16+
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
17+
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
18+
</methodsynopsis>
19+
<simpara>
20+
AEGIS-128L を用いてメッセージを検証し、複合します。
21+
</simpara>
22+
</refsect1>
23+
24+
<refsect1 role="parameters">
25+
&reftitle.parameters;
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>ciphertext</parameter></term>
29+
<listitem>
30+
<simpara>
31+
<function>sodium_crypto_aead_aegis128l_encrypt</function> が生成したフォーマットでなければなりません。
32+
</simpara>
33+
</listitem>
34+
</varlistentry>
35+
<varlistentry>
36+
<term><parameter>additional_data</parameter></term>
37+
<listitem>
38+
<simpara>
39+
追加の認証データ。
40+
これは、
41+
暗号化されたテキストに追加された認証タグを検証するのに用いられますが、
42+
このデータは暗号化されていませんし、
43+
暗号化されたテキストにも保存されていません。
44+
</simpara>
45+
</listitem>
46+
</varlistentry>
47+
<varlistentry>
48+
<term><parameter>nonce</parameter></term>
49+
<listitem>
50+
<simpara>
51+
メッセージごとに一度だけ使われる数値。
52+
</simpara>
53+
</listitem>
54+
</varlistentry>
55+
<varlistentry>
56+
<term><parameter>key</parameter></term>
57+
<listitem>
58+
<simpara>
59+
暗号化キー(128ビット).
60+
</simpara>
61+
</listitem>
62+
</varlistentry>
63+
</variablelist>
64+
</refsect1>
65+
66+
<refsect1 role="returnvalues">
67+
&reftitle.returnvalues;
68+
<simpara>
69+
成功時にプレーンテキストを返します。
70+
&return.falseforfailure;
71+
</simpara>
72+
</refsect1>
73+
74+
<refsect1 role="seealso">
75+
&reftitle.seealso;
76+
<simplelist>
77+
<member><function>sodium_crypto_aead_aegis128l_encrypt</function></member>
78+
<member><function>sodium_crypto_aead_aegis128l_keygen</function></member>
79+
</simplelist>
80+
</refsect1>
81+
</refentry>
82+
<!-- Keep this comment at the end of the file
83+
Local variables:
84+
mode: sgml
85+
sgml-omittag:t
86+
sgml-shorttag:t
87+
sgml-minimize-attributes:nil
88+
sgml-always-quote-attributes:t
89+
sgml-indent-step:1
90+
sgml-indent-data:t
91+
indent-tabs-mode:nil
92+
sgml-parent-document:nil
93+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
94+
sgml-exposed-tags:nil
95+
sgml-local-catalogs:nil
96+
sgml-local-ecat-files:nil
97+
End:
98+
vim600: syn=xml fen fdm=syntax fdl=2 si
99+
vim: et tw=78 syn=sgml
100+
vi: ts=1 sw=1
101+
-->
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 01cb7d495c454cea3828d75e181241b6ac3f15ae Maintainer: Ippey Status: ready -->
4+
<refentry xml:id="function.sodium-crypto-aead-aegis128l-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>sodium_crypto_aead_aegis128l_encrypt</refname>
7+
<refpurpose>AEGIS-128L を使って暗号化し、認証を行う</refpurpose>
8+
</refnamediv>
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>string</type><methodname>sodium_crypto_aead_aegis128l_encrypt</methodname>
13+
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>message</parameter></methodparam>
14+
<methodparam><type>string</type><parameter>additional_data</parameter></methodparam>
15+
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
16+
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
17+
</methodsynopsis>
18+
<simpara>
19+
AEGIS-128L を使って暗号化し、認証を行います。
20+
</simpara>
21+
</refsect1>
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<variablelist>
25+
<varlistentry>
26+
<term><parameter>message</parameter></term>
27+
<listitem>
28+
<simpara>
29+
暗号化するプレーンテキスト
30+
</simpara>
31+
</listitem>
32+
</varlistentry>
33+
<varlistentry>
34+
<term><parameter>additional_data</parameter></term>
35+
<listitem>
36+
<simpara>
37+
追加の認証データ。
38+
これは、
39+
暗号化されたテキストに追加された認証タグを検証するのに用いられますが、
40+
このデータは暗号化されていませんし、
41+
暗号化されたテキストにも保存されません。
42+
</simpara>
43+
</listitem>
44+
</varlistentry>
45+
<varlistentry>
46+
<term><parameter>nonce</parameter></term>
47+
<listitem>
48+
<simpara>
49+
メッセージごとに一度だけ使われる数値。
50+
</simpara>
51+
</listitem>
52+
</varlistentry>
53+
<varlistentry>
54+
<term><parameter>key</parameter></term>
55+
<listitem>
56+
<simpara>
57+
暗号化キー(128ビット).
58+
</simpara>
59+
</listitem>
60+
</varlistentry>
61+
</variablelist>
62+
</refsect1>
63+
<refsect1 role="returnvalues">
64+
&reftitle.returnvalues;
65+
<simpara>
66+
暗号化されたテキストと、
67+
認証タグを生のバイナリのバイト列に含めた文字列を返します。
68+
</simpara>
69+
</refsect1>
70+
<refsect1 role="seealso">
71+
&reftitle.seealso;
72+
<simplelist>
73+
<member><function>sodium_crypto_aead_aegis128l_decrypt</function></member>
74+
<member><function>sodium_crypto_aead_aegis128l_keygen</function></member>
75+
</simplelist>
76+
</refsect1>
77+
</refentry>
78+
<!-- Keep this comment at the end of the file
79+
Local variables:
80+
mode: sgml
81+
sgml-omittag:t
82+
sgml-shorttag:t
83+
sgml-minimize-attributes:nil
84+
sgml-always-quote-attributes:t
85+
sgml-indent-step:1
86+
sgml-indent-data:t
87+
indent-tabs-mode:nil
88+
sgml-parent-document:nil
89+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
90+
sgml-exposed-tags:nil
91+
sgml-local-catalogs:nil
92+
sgml-local-ecat-files:nil
93+
End:
94+
vim600: syn=xml fen fdm=syntax fdl=2 si
95+
vim: et tw=78 syn=sgml
96+
vi: ts=1 sw=1
97+
-->
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 01cb7d495c454cea3828d75e181241b6ac3f15ae Maintainer: Ippey Status: ready -->
4+
<refentry xml:id="function.sodium-crypto-aead-aegis128l-keygen" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>sodium_crypto_aead_aegis128l_keygen</refname>
7+
<refpurpose>Generate a random AEGIS-128L key</refpurpose>
8+
</refnamediv>
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>string</type><methodname>sodium_crypto_aead_aegis128l_keygen</methodname>
13+
<void/>
14+
</methodsynopsis>
15+
<simpara>
16+
<function>sodium_crypto_aead_aegis128l_encrypt</function>
17+
18+
<function>sodium_crypto_aead_aegis128l_decrypt</function>
19+
で使うランダムな鍵を生成します。
20+
</simpara>
21+
</refsect1>
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
&no.function.parameters;
25+
</refsect1>
26+
<refsect1 role="returnvalues">
27+
&reftitle.returnvalues;
28+
<simpara>
29+
128ビット長のランダムな暗号化キーを返します。
30+
</simpara>
31+
</refsect1>
32+
<refsect1 role="seealso">
33+
&reftitle.seealso;
34+
<simplelist>
35+
<member><function>sodium_crypto_aead_aegis128l_decrypt</function></member>
36+
<member><function>sodium_crypto_aead_aegis128l_encrypt</function></member>
37+
</simplelist>
38+
</refsect1>
39+
</refentry>
40+
<!-- Keep this comment at the end of the file
41+
Local variables:
42+
mode: sgml
43+
sgml-omittag:t
44+
sgml-shorttag:t
45+
sgml-minimize-attributes:nil
46+
sgml-always-quote-attributes:t
47+
sgml-indent-step:1
48+
sgml-indent-data:t
49+
indent-tabs-mode:nil
50+
sgml-parent-document:nil
51+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
52+
sgml-exposed-tags:nil
53+
sgml-local-catalogs:nil
54+
sgml-local-ecat-files:nil
55+
End:
56+
vim600: syn=xml fen fdm=syntax fdl=2 si
57+
vim: et tw=78 syn=sgml
58+
vi: ts=1 sw=1
59+
-->

0 commit comments

Comments
 (0)