PHP password_hash() 関数

PHP 密码散列算法PHP パスワードハッシュアルゴリズム

password_hash() 関数は、パスワードのハッシュ(hash)を作成するために使用されます。

PHP バージョン要件: PHP 5 >= 5.5.0, PHP 7

構文

string password_hash ( string $password , int $algo [, array $options ] )

password_hash() は、十分な強度の一方向ハッシュアルゴリズムを使用してパスワードのハッシュ(hash)を作成します。password_hash() は crypt() と互換性があります。したがって、crypt() で作成されたパスワードハッシュも password_hash() で使用できます。

現在サポートされているアルゴリズム:

  • PASSWORD_DEFAULT- bcrypt アルゴリズムを使用(PHP 5.5.0 でデフォルト)。 この定数は、PHP がより強力なアルゴリズムを追加して更新されると変更されることに注意してください。 したがって、この定数を使用して生成された結果の長さは将来変化する可能性があります。 そのため、データベース内で結果を格納する列は60文字以上(できれば255文字)にしてください。
  • PASSWORD_BCRYPT- 使用CRYPT_BLOWFISHアルゴリズムを使用してハッシュを作成します。これにより、"$2y$" を使用したcrypt()。結果は60文字の文字列になります。失敗した場合には返しますFALSE。
  • PASSWORD_ARGON2I- Argon2 ハッシュアルゴリズムを使用してハッシュを作成します。

PASSWORD_BCRYPT がサポートするオプション:

  • salt(string) - ハッシュ化するパスワードのソルト(salt)を手動で提供します。これにより、ソルト(salt)の自動生成が回避されます。

    この値を省略すると、password_hash() は各パスワードハッシュに対してランダムなソルトを自動生成します。この操作は意図的なパターンです。

    注意:ソルト(salt)オプションは PHP 7.0.0 から非推奨(deprecated)になりました。現在は、デフォルトで生成されるソルトを単純に使用することをお勧めします。

  • cost (integer) - アルゴリズムが使用する cost を表します。crypt() ページには cost 値の例があります。

    省略した場合のデフォルト値は 10 です。この cost は良い下限ですが、自分のハードウェアの状況に応じてこの値を増やすこともできます。

PASSWORD_ARGON2I がサポートするオプション:

  • memory_cost (integer) - Argon2 ハッシュ計算時の最大メモリ(単位:バイト byte)。デフォルト値:PASSWORD_ARGON2_DEFAULT_MEMORY_COST。

  • time_cost (integer) - Argon2 ハッシュ計算時の最大時間。デフォルト値:PASSWORD_ARGON2_DEFAULT_TIME_COST。

  • threads (integer) - Argon2 ハッシュ計算時の最大スレッド数。デフォルト値:PASSWORD_ARGON2_DEFAULT_THREADS。

パラメータ説明:

  • password: password_hash() によって作成されたハッシュ値。

  • algo: パスワードをハッシュ化するときにアルゴリズムを指定するためのパスワードアルゴリズム定数。

  • options: オプションを含む連想配列。現在サポートされている2つのオプションは、salt(パスワードをハッシュ化するときに追加するソルト(干渉文字列))と、アルゴリズムの再帰レベルを指定する cost です。これらの2つの値の例は crypt() ページにあります。

    省略した場合、ランダムなソルトとデフォルトの cost が使用されます。

戻り値

ハッシュ化されたパスワードを返します。失敗した場合は FALSE を返します。

例

例 1

<?php /** * デフォルトのアルゴリズムでパスワードをハッシュ化したい * 現在は BCRYPT で、60文字の結果を生成します。 * * デフォルトのアルゴリズムは時間の経過とともに変更される可能性があるため、 * 格納するスペースは60文字以上(255文字が良い)必要です。*/ echo password_hash("rasmuslerdorf", PASSWORD_DEFAULT); ?>

出力結果は次のとおりです。

$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a

例 2

<?php /** * このケースでは、BCRYPT の cost を 12 に増やしています。 * 注意:既に切り替えているため、常に60文字が生成されます。*/ $options = [ 'cost' => 12, ]; echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options); ?>

出力結果は次のとおりです。

$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K

例 3

ソルトを手動で設定する例

<?php /** * 注意:ここのソルトはランダムに生成されます。 * 固定のソルトやランダムに生成されていないソルトは決して使用しないでください。 * * ほとんどの場合、password_hash generate にランダムなソルトを自動生成させることができます。*/ $options = [ 'cost' => 11, 'salt' => mcrypt_create_iv(22, MCRYPT_DEV_URANDOM), ]; echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options); ?>

出力結果は次のとおりです。

$2y$11$q5MkhSBtlsJcNEVsYh64a.aCluzHnGog7TQAKVmQwO9C8xb.t89F.

例 4

最適な cost を見つけるための password_hash() の例

<?php /** * この例ではサーバーにベンチマーク(benchmark)を実行し、サーバーがどの程度の cost に耐えられるかを確認します。 * サーバーを著しく遅くすることなく、設定できる最大の値 * 8〜10 は適切な下限で、サーバーが十分に高速であれば、高ければ高いほど良いです。 * 以下のコードは ≤ 50 ミリ秒(milliseconds)を目標としています。 * インタラクティブなログイン処理に適しています。*/ $timeTarget = 0.05; //50 ミリ秒(milliseconds) $cost = 8; do { $cost++; $start = microtime(true); password_hash("test", PASSWORD_BCRYPT, ["cost" => $cost]); $end = microtime(true); } while (($end - $start) < $timeTarget); echo "Appropriate Cost Found: " . $cost; ?>

出力結果は次のとおりです。

Appropriate Cost Found: 10

例 5

Argon2 を使用する例:

<?php echo 'Argon2 hash: ' . password_hash('rasmuslerdorf', PASSWORD_ARGON2I); ?>

出力結果は次のとおりです。

Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0

PHP 密码散列算法PHP パスワードハッシュアルゴリズム

他の拡張機能