2026年5月20日

2026年5月20日

エックスサーバーのデータベースエラーをWP-CLIで解決する方法

はじめに

エックスサーバーはWordPressでの利用者が多い国内最大手のレンタルサーバーです。DB接続エラーが発生した場合の確認方法はエックスサーバー特有の手順があります。また、エックスサーバーではSSH接続とWP-CLIが使えるため、高度なDB修復操作も可能です。

エックスサーバー特有のDB設定

// エックスサーバーのwp-config.php例
define('DB_NAME',     'example_wp');           // サーバーパネルで確認
define('DB_USER',     'example_user');          // サーバーパネルで確認
define('DB_PASSWORD', 'パスワード');
define('DB_HOST',     'mysql[番号].xserver.jp'); // サーバーパネルのMySQL情報で確認

重要: エックスサーバーではDB_HOSTがlocalhostではなくmysql[番号].xserver.jpになる場合があります。

DB設定の確認場所

サーバーパネルでの確認

1. エックスサーバーのサーバーパネル(https://www.xserver.ne.jp/login_server.php)にログイン

2. 「MySQL設定」→「MySQLユーザー一覧」でユーザー名を確認

3. 「MySQL情報」でホスト名を確認

4. 「MySQL一覧」でDB名を確認

解決手順

ステップ1:サーバーパネルでDB情報を照合

FTPでwp-config.phpを開き、サーバーパネルのMySQL情報と比較します。不一致があれば修正します。

ステップ2:phpMyAdminで接続確認

1. サーバーパネル → 「MySQL設定」→「phpmyadmin」

2. 正しいユーザー名・パスワードでログイン試行

3. ログインできれば接続情報は正しい

ステップ3:SSHでWP-CLIを使う

エックスサーバーではSSH接続が可能です。WP-CLIを使ってDB状態を確認・修復できます:

# SSH接続後
# WP-CLIのインストール(未インストールの場合)
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
mv wp-cli.phar ~/bin/wp

# WordPressの状態確認
cd /home/ユーザー名/ドメイン名/public_html/
wp core verify-checksums  # コアファイルの整合性確認

# DBの確認
wp db check  # DBの状態確認

# DBの修復
wp db repair  # 破損テーブルの修復

# キャッシュのクリア
wp cache flush

ステップ4:WP-CLIでURL一括置換(移転後のエラー)

移転後にURLが変わった場合:

# ドライラン(置換内容の確認)
wp search-replace 'https://old-domain.com' 'https://new-domain.com' --dry-run

# 実際の置換
wp search-replace 'https://old-domain.com' 'https://new-domain.com'

# パーマリンクのリセット
wp rewrite flush --hard

ステップ5:パスワードをリセットする

1. サーバーパネル → 「MySQL設定」→「MySQLユーザー一覧」

2. 対象ユーザーの「パスワード変更」で新パスワードを設定

3. wp-config.phpDB_PASSWORDを更新してFTPアップロード

ステップ6:エックスサーバーの障害情報を確認

設定が正しいにも関わらずエラーが続く場合:

エックスサーバー障害情報: https://info.xserver.ne.jp/server/

エックスサーバーのSSH接続設定

SSH接続には事前にサーバーパネルで有効化が必要です:

1. サーバーパネル → 「サーバー情報」→「SSH設定」

2. 「ONにする」をクリック

3. 接続コマンド:ssh ユーザー名@ユーザー名.xsrv.jp -p 10022

まとめ

エックスサーバーでのDB接続エラーは、サーバーパネルでDB情報を確認してwp-config.phpと照合することで大半が解決します。エックスサーバーはSSHとWP-CLIが使えるため、wp db checkwp db repairwp search-replaceなどの高度な修復操作も可能です。

関連記事:

お気軽にご相談ください

お見積りへ お問い合わせへ