password_verify is capable of verifying crypt hashes

php/doc-en@f93ab99

Author: mumumu

reference/password/functions/password-hash.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 98ba3bd97a8f988e69054ee7e7aa2fd124d453a7 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: f93ab9943c0246504e18493e315b7638efe81753 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">
@@ -18,11 +18,9 @@
    <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
   </methodsynopsis>
   <para>
-   <function>password_hash</function> は、強力な一方向ハッシュアルゴリズムを使って
+   <function>password_hash</function> は、
+   強力な一方向ハッシュアルゴリズムを使って、
    新しいパスワードハッシュを作ります。
-   <function>password_hash</function> は <function>crypt</function> と互換性があるので、
-   <function>crypt</function> が作ったパスワードハッシュは
-   <function>password_hash</function> でも使えます。
   </para>
   <simpara>
    現在、以下のアルゴリズムに対応しています。

reference/password/functions/password-verify.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: be96542e25353334c13edc6c5bc39cc96eb46306 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: f93ab9943c0246504e18493e315b7638efe81753 Maintainer: takagi Status: ready -->
 
 <refentry xml:id="function.password-verify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,10 @@
   </methodsynopsis>
   <para>
    指定したハッシュがパスワードにマッチするかどうかを調べます。
+   <function>password_verify</function> は
+   <function>crypt</function> と互換性があるので、
+   <function>crypt</function> が作ったパスワードハッシュは
+   <function>password_verify</function> でも使えます。
   </para>
   <para>
    <function>password_hash</function> は、

reference/strings/functions/crypt.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 98ba3bd97a8f988e69054ee7e7aa2fd124d453a7 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: f93ab9943c0246504e18493e315b7638efe81753 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.crypt">
  <refnamediv>
@@ -23,6 +23,10 @@
    <function>crypt</function> 文字列のハッシュを返します。
    Unix 標準の <abbrev>DES</abbrev> ベースのアルゴリズムか、
    代替のアルゴリズムを使用します。
+   <function>password_verify</function> は
+   <function>crypt</function> と互換性があるので、
+   <function>crypt</function> が作ったパスワードハッシュは
+   <function>password_verify</function> でも使えます。
   </para>
   <para>
    <parameter>salt</parameter> パラメータは必須ではありませんが、これを省略すると
@@ -62,11 +66,13 @@
    </listitem>
    <listitem>
     <simpara>
-     <constant>CRYPT_EXT_DES</constant> - 拡張した DES ベースのハッシュ。"salt" は 9 文字で、
-     アンダースコアの後に 4 バイトの反復回数と 4 バイトの salt が続きます。
-     これらが表示可能な文字にエンコードされます。一文字あたり 6 ビットで、
+     <constant>CRYPT_EXT_DES</constant> - 拡張した DES ベースのハッシュ。
+     "salt" は 9 文字で、
+     アンダースコアの後に 4 文字の反復回数と 4 文字の salt が続きます。
+     これらの4文字それぞれが、24ビットにエンコードされ、
      下位の文字から順に並びます。
-     0 から 63 までの値は "./0-9A-Za-z" とエンコードされます。
+     <literal>0</literal> から <literal>63</literal> までの値は
+     <literal>./0-9A-Za-z</literal> の範囲内の文字でエンコードされます。
      salt に無効な文字を使うと crypt() は失敗します。
     </simpara>
    </listitem>