Local by flywheel でデータベース接続エラーが出た場合の復旧方法

先日、OSをアップデートしてから Local by flywheel でデータベース接続エラーが頻発するようになりました。

具体的には20個ほど Local で作ったサイトがあったのですが、その半分ぐらいで接続エラーが出てサイトが見れない状態に。いろいろ調べてデータベースのリセットを試みたりしたのですが復旧せず。

万事休すかと思ったのですが、実はLocalはサイトを停止させる毎にデータベースの内容を書き出して保存してくれています。同じ名前で新しくサイトを作ってそのデータベースをインポートすれば全く同じサイトを復活させることができます。

この記事はエラー解消のためにやってダメだったことと、その手順の覚書です。Local で同じようなトラブルで困った方は試してみてください。簡単、確実に復旧できます。

表示されるエラーとやってみたこと

ここはエラーを解決しようと悪戦苦闘した話です。とにかくすぐに復旧させたい人はここは飛ばしてください。

ちなみにどんなエラーが出ていたかですが、Local で稼働させたサイトにアクセスすると

というPHPの警告と「データベース接続確立エラー」と表示される状態でした。下図のような画面になります。

やってみたこと1： ホスト名を変える

まずエラー名でググるとデータベースのホスト名をlocalhostから127.0.0.1に変えるとつながるという情報が沢山でてきます。wp-config.phpはデフォルトでは下記のようになっているはず。

define( 'DB_HOST', 'localhost' );

これを次のように書き換えてみました。

define( 'DB_HOST', '127.0.0.1' );

結果としてはデータベース接続エラーは変わらなかったのですが、phpの警告の内容が変わりました。

見つからないから拒絶に…。

やってみたこと2： ターミナルから操作を試みる

拒絶されるというならターミナルからmysqlにアクセスできるのかと思いやってみると次のようなエラーが。

$ mysgl
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/Users/ユーザー名/Library/Application Support/Local/run/wMAPoFakV/mysql/mysqld.sock' (2

socketを通して接続ができないということのようです。mysqld.sock というファイルの存在は確認し、アクセス権をフルアクセスに変えてみてもダメ。

やってみたこと3： データベースの再起動

いろいろ調べているとmysql.server startというコマンドでデータベースを再起動できるとう情報をゲット。

これで解決の糸口がつかめるかと思ってやってみると…

ERROR! The server quit without updating PID file (/Users/ユーザ名/Library/Application/******.local.pid).

上記のようなエラーがでるだけで状況は変わらず・・・

やってみたこと4： サイトのエクスポート

このあたりで手に負えないと判断し、閃いた方法が「サイトをエクスポートしてインポートすればなおるのでは？」だったのですが…

エクスポートができませんでした。待てど暮らせど終わらない…。データベースが正常に動いてないようなので仕方ないかもしれません。

万事休すかと思ったのですが、ここでふと Local は毎回データベースを自動的にバックアップしていることを思いだしました。

ということで、長い前振りは終わりでいよいよ本題に入っていきます。

Local のバックアップを利用した復元

steplocal.sqlとwp-content を移動orコピー

データベースのバックアップはサイトフォルダ/app/sql/の中にあるloacl.sql とういファイルです。たまにこのフォルダの中に大量にテーブル毎のバックアップファイルが保存されている場合がありますが、使うのはlocal.sqlだけで大丈夫なはず。

これとサイトフォルダ/app/public/の中にあるwp-contentフォルダを別のフォルダに移動するかコピーしておきます。ファイルが大量にある場合は移動の方が時間がかからないです。

あとサイト名も忘れないようにしましょう。

stepサイトをLocalから削除

データのバックアップが完了したら、Localからサイトを削除。wp-content等も含め全てのファイルが削除されるので必ずstep1をやってから実行してましょう。

step同じ名前でサイトを新規作成

削除が完了したら全く同じ名前でサイトを新規作成します。

余計なトラブルを避けるためPHPやデータベースのバージョンは前と同じにしておきましょう。ユーザー名とパスワードは後で書き換わるので適当でOK。サイト作成後ログインする必要はありません。

ちなみに別の名前にしたい場合、local.sql内のサイト名の部分を全て置換すれば対応できます。

stepwp-contnetをコピー

新しく作ったサイトのwp-contentをバックアップしていたものに入れ替えます。

stepデータベースにバックアップをインポイート

Local のDATABASEタブをクリックしてOPEN ADMINERをクリック。

これでブラウザにadminerの画面が表示されます。

全てのテーブルにチェックを入れて削除をクリック。

これでデータベースが空になるのでインポートをクリック。

インポートからコピーしておいた local.sql を選択して「実行」

データベースの容量が大きいと結構感がかかりますが、無事にインポートが完了するとテーブルが表示されます。

stepサイトを確認

以上で前と全く同じサイトが復活しているはずです。管理画面のログイン情報も前と同じでいけます。

実際の作業は数分で完了するので、データベースを復旧しようとあれこれ悩んだりサイトのエクスポートをするよりもこちらの方が迅速に環境を復活できると思います。

最近はwp-envを使うことが多いのですが、Local もこういう自動バックアップ機能があるなど痒いところに手が届くのは便利だなと改めて思いました。

当面使わないサイトはデータベースとwp-contentの必要な部分だけバックアップして必要な時にインポートするという運用でいけばSSDの容量節約にもなりそうです。