MySQL のパスワード変更後、WordPress がデータベースに接続できない

MySQL のパスワードを変更した後は、WordPress のルートディレクトリにある wp-config.php もあわせて更新する必要があります。WordPress のインストール時、データベース接続情報はこのファイルに書き込まれます。MySQL アカウントのパスワードが変わっているのに、wp-config.php に古いパスワードが残ったままだと、当然 WordPress はデータベースに接続できません。

よく見られるエラーは次のようなものです。

Error establishing a database connection

対処手順は以下のとおりです。

1. WordPress のルートディレクトリに移動し、まず設定ファイルをバックアップします。

cp wp-config.php wp-config.php.bak

1. wp-config.php を開き、データベース設定を探します。

define('DB_NAME', 'データベース名');
define('DB_USER', 'データベースユーザー名');
define('DB_PASSWORD', 'データベースパスワード');
define('DB_HOST', 'localhost');

1. DB_PASSWORD を、現在の MySQL ユーザーの新しいパスワードに変更します。

1. それでも接続できない場合は、DB_USER、DB_NAME、DB_HOST が正しいか確認します。多くのホスティング環境では localhost を使いますが、サーバーによっては具体的なデータベースホスト名を指定する必要があります。

1. コマンドラインを使える場合は、同じユーザー名とパスワードで MySQL にログインできるか確認します。

mysql -u データベースユーザー名 -p データベース名

ログインできれば、MySQL アカウント自体は利用可能です。ログインに失敗する場合は、MySQL ユーザーのパスワード、権限、またはそのユーザーが現在のホストから接続を許可されているかを確認する必要があります。

WordPress は、MySQL データベースのパスワードを変更したことを自動では認識できません。そのため、データベースのパスワードを変更した後は、必ず wp-config.php も忘れずに更新してください。