Title: PHP Native Password Hash
Author: Ayesh Karunaratne
Published: <strong>2017年1月4日</strong>
Last modified: 2024年6月10日

---

プラグインを検索

![](https://ps.w.org/password-hash/assets/banner-772x250.png?rev=1569073)

このプラグインは **WordPress の最新3回のメジャーリリースに対してテストされていま
せん**。もうメンテナンスやサポートがされていないかもしれず、最新バージョンの WordPress
で使用した場合は互換性の問題が発生する可能性があります。

![](https://ps.w.org/password-hash/assets/icon-256x256.png?rev=1569084)

# PHP Native Password Hash

 作者: [Ayesh Karunaratne](https://profiles.wordpress.org/ayeshrajans/)

[ダウンロード](https://downloads.wordpress.org/plugin/password-hash.3.0.zip)

 * [詳細](https://ja.wordpress.org/plugins/password-hash/#description)
 * [レビュー](https://ja.wordpress.org/plugins/password-hash/#reviews)
 *  [インストール](https://ja.wordpress.org/plugins/password-hash/#installation)
 * [開発](https://ja.wordpress.org/plugins/password-hash/#developers)

 [サポート](https://wordpress.org/support/plugin/password-hash/)

## 説明

This plugin swaps out WordPress core’s password hashing mechanism with PHP 5.5’s`
password_hash()` and its accompanying functions. By default, PHP uses bcrypt to 
hash the passwords. If available, this plugin will use modern Argon2 algorithm. 
The transition will be transparent.

 * A password salt will be generated using a Cryptographically Secure Pseudo-Random
   Number Generator (`CSPRNG`)
 * Password hashes are safe from dictionary attacks with rainbow tables or any other
   precomputed hash lists, because a secure salt is generated for each password.
 * The password hashing is iterated multiple times to provide a good resistance 
   against brute-force attacks.
 * Password checks are made in a way that it mitigates time-attacks.
 * You do not have to reset passwords of all users. Passwords already hashed in 
   the database will be rehashed automatically and transparently the next time the
   user logs in.
 * PHP might come up with newer password hashing algorithms, and they will be automatically
   supported without having to reset all the passwords.

This plugin was made initially because one of our applications used WordPress for
authentication, but we needed to use an external system
 to verify the passwords
directly from the database too. Since WordPress has its own password hashing algorithm,
we decided to make this plugin to address that problem. With this plugin, passwords
generated by both WordPress and other custom applications now use the PHP’s default`
password_hash()` functions without compromising any of the applications’ security.

This plugin is designed to be as minimal and fast as possible, and can be considered
a must-use for EVERY WordPress application given the minimal footprint of this plugin,
and considering the importance of using a secure hashing algorithm for passwords.

## インストール

 1. Upload the plugin files to the `/wp-content/plugins/password-hash` directory, or
    install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress.
 3. You are all set! There is nothing to configure. All existing users passwords will
    be rehashed on their next successful login. There is no configuration UI; it just
    works.

## FAQ

### Do I have to reset all existing passwords?

Nope! This plugin is smart enough to identify an old password hash, capable to seamlessly
validate it using the old algorithm, and update the hash with the new version automatically.
Your users wouldn’t notice a thing.

### What happens if I uninstall this plugin?

Password hashing is a one-way operation, and it’s near impossible to extract the
original password from the hash. This
 means we cannot undo the effect of this plugin.
Your existing users will need to reset their passwords. However, your password hashes
will remain safe. This plugin is does one specific thing and does it well. There
should be no significant impact on using this plugin.

### How do I confirm the new hashing algorithm is in use?

The easiest way would be to check your database from PHPMyAdmin or any other software
in its line. Check if the password
 hash field in your users table has the format`
$2y$10...`. Those who have not updated their hashes will have a different format.
However, if the plugin is unable to override the password hashing algorithm from
WordPress core, you will see a notification in your dashboard. If you do not see
anything, you are golden.

### How to use `Argon2I` and `Argon2ID` hashing algorithms?

To keep the plugin size minimal, this plugin does not offer a UI configuration page.
You can set the password hashing
 algorithm with a configuration value set in `wp-
config.php` file.

Open your `wp-config.php` file at the root of your WordPress site, and find the 
line that says `That's all, stop editing! Happy publishing`.
 Above this line, you
can configure the hashing algorithm you want this plugin to use. Note that a wrong
configuration value means your users will not be able to log in until you fix this
configuration option. It’s not recommended that you set this configuration value
unless you know what you are doing.

    ```
    define( 'WP_PASSWORD_HASH_ALGO', PASSWORD_ARGON2ID );
    ```

You can use the following values depending on your PHP version:
 – **PHP 7.2 or 
later**: `PASSWORD_ARGON2I` – **PHP 7.3 or later**: `PASSWORD_ARGON2ID` (recommended)

### How do I configure options for the specified hashing algorithm?

Alrighty folks, read carefully: This plugin can listen to a configuration option
you specify and pass it along to the hashing
 process. Please make sure you are 
absolutely sure about the values you set here. If you set a value too easy to crack,
you will open up a security vulnerability in your site. If you set a value too high,
your server will take too much resources.

This plugin does not make any effort to _validate_ the configuration you set. If
you do not configure a value, plugin will
 use the default value your PHP version
comes with.

If you would still like to configure these options, similar to the way you set the
hashing algorithm, open the `wp-config.php`
 file for your WordPress site (at root
of your WordPress installation), and right below the line that you configure hashing
algorithm (see FAQ above), set your configuration values as well. Here is an example(
not necessarily a recommendation):

    ```
    define( 'WP_PASSWORD_HASH_OPTIONS', ['memory_cost' => 2<<16, 'time_cost' => \PASSWORD_ARGON2_DEFAULT_TIME_COST, 'threads' => \PASSWORD_ARGON2_DEFAULT_THREADS]] );
    ```

The values you set here will be different based on the algorithm you set. You _must_
set the `WP_PASSWORD_HASH_ALGO`
 configuration in order for this to be effective.

See https://www.php.net/manual/en/password.constants.php for more examples and information.

**Existing password hashes will be updated the next time the user logs in. Existing
hashes will be checked using the existing algorithm regardless of this configuration.**

### How did pirates collaborate before computers?

Pier to pier networking.

## 評価

![](https://secure.gravatar.com/avatar/032c7907be94c1423ec992cc8ea77ef70cfe34c31707e006366757e8ff036813?
s=60&d=retro&r=g)

### 󠀁[Amazing](https://wordpress.org/support/topic/amazing-4103/)󠁿

 [fenvi](https://profiles.wordpress.org/fenvi/) 2025年3月8日

Works very well.

![](https://secure.gravatar.com/avatar/f9f52d3fad1b0017e643183c5d8d4aa8c875558f7788ea66c9cca1a41d9ec5d5?
s=60&d=retro&r=g)

### 󠀁[Very good security addition](https://wordpress.org/support/topic/very-good-security-addition/)󠁿

 [Yambub](https://profiles.wordpress.org/yambub/) 2021年2月7日

Thanks for this plugin and especially for keeping it up to date.

![](https://secure.gravatar.com/avatar/b5a6d52ecf8d3280f38a15f2494faf10c9c239637a760f2e35bfe7fe88e8b585?
s=60&d=retro&r=g)

### 󠀁[Thanks very much!](https://wordpress.org/support/topic/thanks-very-much-5/)󠁿

 [minishman](https://profiles.wordpress.org/minishman/) 2018年11月23日

Can’t believe WP is still using MD5 by default o.O As soon as I learned about this,
I got this plugin, and it does exactly what you want, using Wordpress built in functions,
so totally lightweight. Thanks dev!

![](https://secure.gravatar.com/avatar/aefbad5c18d6706a1d086c81c225feed9f642862d4456594ac0184db879ab793?
s=60&d=retro&r=g)

### 󠀁[Exellent](https://wordpress.org/support/topic/exellent-67/)󠁿

 [mpompas](https://profiles.wordpress.org/mpompas/) 2018年2月26日

Works as expected.

![](https://secure.gravatar.com/avatar/39437f36d387b37d6f065fd05fbb783be892f5fe9921347debcc2ebc622c0b04?
s=60&d=retro&r=g)

### 󠀁[Superb](https://wordpress.org/support/topic/superb-405/)󠁿

 [birkof007](https://profiles.wordpress.org/birkof007/) 2017年2月18日

Geniality is in simplicity.

![](https://secure.gravatar.com/avatar/f0cc0d4808d1ad4603f95b1af2e3dd830c7278aef5bc42522ada517061cdd16e?
s=60&d=retro&r=g)

### 󠀁[Thanks](https://wordpress.org/support/topic/thanks-463/)󠁿

 [Thilina Dharmasena](https://profiles.wordpress.org/mthilinaharmasena/) 2017年1
月6日

It’s Working fine. Thanks…

 [ 6件のレビューをすべて表示 ](https://wordpress.org/support/plugin/password-hash/reviews/)

## 貢献者と開発者

PHP Native Password Hash はオープンソースソフトウェアです。以下の人々がこのプラグ
インに貢献しています。

貢献者

 *   [ Ayesh Karunaratne ](https://profiles.wordpress.org/ayeshrajans/)

[“PHP Native Password Hash” をあなたの言語に翻訳しましょう。](https://translate.wordpress.org/projects/wp-plugins/password-hash)

### 開発に興味がありますか ?

[コードを閲覧](https://plugins.trac.wordpress.org/browser/password-hash/)するか、
[SVN リポジトリ](https://plugins.svn.wordpress.org/password-hash/)をチェックする
か、[開発ログ](https://plugins.trac.wordpress.org/log/password-hash/)を [RSS](https://plugins.trac.wordpress.org/log/password-hash/?limit=100&mode=stop_on_copy&format=rss)
で購読してみてください。

## 変更履歴

#### 1.0

 * Initial release.

#### 1.1

 * Fixed a bug for PHP 5.5 users whose PHP core lacks the time-safe hash_equals 
   function, resulting in a fatal error. This version introduces a polyfill to add
   that functionality for PHP 5.5 users. Users with newer PHP versions will use 
   PHP-provided hash_equals() function.

#### 1.2

 * This plugin now requires WordPress minimum version 3.9.2 the least, and uses 
   the hash_equals() function polyfill provided by WordPress core.

#### 1.4

 * Skipped 1.3 version because a WIP Argon2i support conflicted with the bug fix(#
   2). Argon2i support will be added in a future release.
 * Fixes an error with password validation when the PasswordHash class from WordPress
   core is not loaded. See https://github.com/Ayesh/wordpress-password-hash/pull/
   2

#### 1.5

 * Fix a security issue with the password verification when updating from a password_hash()-
   compatible hashing algorithm to another. Thanks to Steve Thomas (Sc00bz on GitHub).

#### 2.0

This is a major rewrite of the plugin. This version still requires PHP 5.5, but 
WordPress 5.2+ now requires PHP version 5.6 to function, and this is enforced at
plugin level as well.

Core functionality of the plugin is extracted to a separate class. This plugin aims
to be as light-weight as possible, and this version cuts the main plugin file size
to less than half the v1.x size.

There is a new namespaced PasswordHash class that is cleaner and well-structured
compared to our v1 code base.

 * Fixes a bug that the hook-provided hash cost changes did not trigger a password
   rehash. Thanks to Steve Thomas (Sc00bz on GitHub).
 * Adds support for Argon2I, Argon2ID and any future hashing algorithms PHP will
   introduce. See the updated FAQ item on how to use the new hashing algorithms.
 * Removed a helper function used to trigger an admin warning if the plugin cannot
   properly work. The notices are now shown with help of lambda functions (which
   further reduces the code bloat and load).

#### 2.1

 * Adds support for “WP_PASSWORD_HASH_OPTIONS” configuration option that can be 
   set in `wp-config.php` to configure password hashing options.
 * Update WordPress core “Tested up to” field to WordPress 5.6.

#### 3.0

 * Drops support for PHP < 7.0
 * Class methods and functions have return types where applicable.
 * Tested upto WordPress 6.3
 * Uses FQFN/FQCN where available as a micro-optimization

## メタ

 *  バージョン **3.0**
 *  最終更新日 **2年前**
 *  有効インストール数 **1,000+**
 *  WordPress バージョン ** 5.2またはそれ以降 **
 *  検証済み最新バージョン: **6.5.10**
 *  PHP バージョン ** 7.0またはそれ以降 **
 *  言語
 * [English (US)](https://wordpress.org/plugins/password-hash/)
 * タグ
 * [argon2](https://ja.wordpress.org/plugins/tags/argon2/)[bcrypt](https://ja.wordpress.org/plugins/tags/bcrypt/)
   [password](https://ja.wordpress.org/plugins/tags/password/)[password hashing](https://ja.wordpress.org/plugins/tags/password-hashing/)
 *  [詳細を表示](https://ja.wordpress.org/plugins/password-hash/advanced/)

## 評価

 5つ星中5つ星

 *  [  6 5-星レビュー     ](https://wordpress.org/support/plugin/password-hash/reviews/?filter=5)
 *  [  0 4-星レビュー     ](https://wordpress.org/support/plugin/password-hash/reviews/?filter=4)
 *  [  0 3-星レビュー     ](https://wordpress.org/support/plugin/password-hash/reviews/?filter=3)
 *  [  0 2-星レビュー     ](https://wordpress.org/support/plugin/password-hash/reviews/?filter=2)
 *  [  0 1-星レビュー     ](https://wordpress.org/support/plugin/password-hash/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/password-hash/reviews/#new-post)

[すべてのレビューを見る](https://wordpress.org/support/plugin/password-hash/reviews/)

## 貢献者

 *   [ Ayesh Karunaratne ](https://profiles.wordpress.org/ayeshrajans/)

## サポート

意見や質問がありますか ?

 [サポートフォーラムを表示](https://wordpress.org/support/plugin/password-hash/)