From c33a166f15695e4115ccdf023e0daf372b01b541 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?=
 <takeda@youmind.jp>
Date: Sun, 20 Sep 2026 13:09:09 +0900
Subject: [PATCH] =?UTF-8?q?Argon2=20=E3=81=AE=20memory=5Fcost=20=E3=81=A8?=
 =?UTF-8?q?=20time=5Fcost=20=E3=81=AE=E5=8D=98=E4=BD=8D=E3=81=AE=E8=AA=AC?=
 =?UTF-8?q?=E6=98=8E=E3=82=92=E5=8E=9F=E6=96=87=E3=81=AB=E8=BF=BD=E5=BE=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

php/doc-en@6cc48aed6f (php/doc-en#5219) に追従します。

time_cost を「計算にかけてよい時間の最大値」としていた誤りが修正されて反復回数
(パス数) になり、PASSWORD_ARGON2_DEFAULT_MEMORY_COST の単位がキビバイトであることが
明示され、PASSWORD_BCRYPT_DEFAULT_COST に説明が追加されました。

## 対象ファイル (2件)

- reference/password/constants.xml
- reference/password/functions/password-hash.xml
---
 reference/password/constants.xml              | 41 ++++++++++---------
 .../password/functions/password-hash.xml      | 12 +++---
 2 files changed, 28 insertions(+), 25 deletions(-)

diff --git a/reference/password/constants.xml b/reference/password/constants.xml
index a4007ea23b..5bb367b118 100644
--- a/reference/password/constants.xml
+++ b/reference/password/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 66aff414be91c5a0446be585aa6ac78121de1e67 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6cc48aed6f887bdabf09c568f854099f9c74e017 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <appendix xml:id="password.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -57,10 +57,13 @@
      (<type>int</type>)
     </term>
     <listitem>
-     <para>
-     </para>
-     <para>
-     </para>
+     <simpara>
+      <constant>PASSWORD_BCRYPT</constant> でパスワードをハッシュするときに
+      <function>password_hash</function> が使う、デフォルトのアルゴリズムのコスト。
+     </simpara>
+     <simpara>
+      PHP 7.0.0 以降で利用可能です。
+     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.password-argon2i">
@@ -80,16 +83,16 @@
       <listitem>
        <para>
         <literal>memory_cost</literal> (<type>int</type>) -
-        Argon2 ハッシュの計算に用いるメモリの最大値 (キロバイト数) を設定します。
+        Argon2 ハッシュの計算に用いるメモリの最大値 (KiB 単位) を設定します。
         デフォルトは <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant> です。
        </para>
       </listitem>
       <listitem>
-       <para>
+       <simpara>
         <literal>time_cost</literal> (<type>int</type>) -
-        Argon2 ハッシュの計算にかける時間の最大値を設定します。
+        Argon2 ハッシュの計算に用いる反復回数 (パス数) を設定します。
         デフォルトは <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant> です。
-       </para>
+       </simpara>
       </listitem>
       <listitem>
        <para>
@@ -130,12 +133,12 @@
      (<type>int</type>)
     </term>
     <listitem>
-     <para>
-      ハッシュの計算に用いるメモリのデフォルト値。
-     </para>
-     <para>
+     <simpara>
+      ハッシュの計算に用いるメモリのデフォルト値。単位はキビバイト (KiB) です。
+     </simpara>
+     <simpara>
       PHP 7.2.0 以降で利用可能です。
-     </para>
+     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.password-argon2-default-time-cost">
@@ -144,12 +147,12 @@
      (<type>int</type>)
     </term>
     <listitem>
-     <para>
-      ハッシュの計算にかける時間のデフォルト値。
-     </para>
-     <para>
+     <simpara>
+      ハッシュの計算に用いる反復回数 (パス数) のデフォルト値。
+     </simpara>
+     <simpara>
       PHP 7.2.0 以降で利用可能です。
-     </para>
+     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.password-argon2-default-threads">
diff --git a/reference/password/functions/password-hash.xml b/reference/password/functions/password-hash.xml
index c7899eae7b..b9a5e1e28a 100644
--- a/reference/password/functions/password-hash.xml
+++ b/reference/password/functions/password-hash.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5003a6ea92eb50ac92121782eedfc5ad3fe9d061 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6cc48aed6f887bdabf09c568f854099f9c74e017 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.password-hash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -105,16 +105,16 @@
     <listitem>
      <para>
       <literal>memory_cost</literal> (<type>int</type>) - Argon2 ハッシュを計算するのに
-      使われるメモリの最大値(キビバイト単位)。
+      使われるメモリの最大値 (KiB 単位)。
       デフォルトは <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant> です。
      </para>
     </listitem>
     <listitem>
-     <para>
-      <literal>time_cost</literal> (<type>int</type>) - Argon2 ハッシュを計算するのに
-      使って良い時間の最大値。
+     <simpara>
+      <literal>time_cost</literal> (<type>int</type>) - Argon2 ハッシュを計算する際の
+      反復回数 (パス数)。
       デフォルトは <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant> です。
-     </para>
+     </simpara>
     </listitem>
     <listitem>
      <para>