PHP password_hash() 関数
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
出力結果は次のとおりです。
$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
例 2
出力結果は次のとおりです。
$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
例 3
ソルトを手動で設定する例
出力結果は次のとおりです。
$2y$11$q5MkhSBtlsJcNEVsYh64a.aCluzHnGog7TQAKVmQwO9C8xb.t89F.
例 4
最適な cost を見つけるための password_hash() の例
出力結果は次のとおりです。
Appropriate Cost Found: 10
例 5
Argon2 を使用する例:
出力結果は次のとおりです。
Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0他の拡張機能
PHP パスワードハッシュアルゴリズム