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.phpのDB_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 check・wp db repair・wp search-replaceなどの高度な修復操作も可能です。
関連記事: