メインコンテンツへスキップ
見出し画像

エックスサーバーで快適に使っていたWordPress+SQLiteを、結局MariaDBへ戻した話

    エックスサーバーでWordPressのブログを運営し、データベースにはSQLite Database Integrationを使っていました。

    エックスサーバーもSQLiteも気に入っていたので、しばらくはこの組み合わせで十分だと思っていました。
    ところがプラグインをv3へ更新した際にエラーが発生。
    調べてみると、使っていたサーバーのSQLiteが古く、更新後の要件を満たしていませんでした。

    最終的にはMariaDBへ移行できましたが、思いのほか手間がかかりました。

    そもそも、なぜSQLiteを使っていたのか

    エックスサーバーは管理画面が使いやすく、PHPのバージョン切り替えも簡単。
    自動バックアップや復元機能、パフォーマンス、セキュリティ、料金のバランスにも満足しています。

    その環境で、WordPressをSQLiteで動かすのは魅力的でした。

    SQLiteはデータベースをファイルとして扱えます。
    別のデータベースサーバーを意識せず、小さなブログをよりシンプルに管理できると思ったのです。
    エックスサーバーのファイルバックアップ機能とも相性がよさそうでした。
    ただし、稼働中のDBファイルを単純にコピーするだけで、安全なバックアップになるとは限りません。

    以前にはSQLite Database Integrationを紹介する記事を書いたほどで、実際の運用にも大きな不満はありませんでした。

    更新エラーの原因は、PHPではなくSQLiteのバージョン

    SQLite Database Integration v3.0では、MySQL向けのSQLをSQLiteで扱うドライバーが刷新され、SQLiteの要件も変わりました。

    • v3の基本要件:SQLite 3.37.0以上

    • 限定的な互換モード:SQLite 3.27.0〜3.36系

    • 筆者が利用していたエックスサーバー環境:SQLite 3.26.0

    互換モードの対象にすら入っていませんでした。

    エックスサーバーでは比較的新しいPHPを簡単に選べます。
    だからSQLiteも新しいものが使えるのだろうと思っていたのですが、PHP本体と、その拡張が使用するSQLiteライブラリのバージョンは別です。
    PHPのバージョンを切り替えても、今回の問題は解消しませんでした。

    これは2026年11月に筆者の環境で確認した結果です。
    エックスサーバーのすべての環境で同じだと確認したわけではありません。

    データベースを扱うプラグインだからこそ、更新前に知らせてほしい

    通常の機能追加プラグインと違って、SQLite Database IntegrationはWordPressのデータベース接続部分を担います。
    互換性がないと、WordPressそのものが動かなくなるおそれがあります。

    要件がリリースノートに書かれているのは分かります。
    でも、更新前に実際のSQLiteバージョンを検査し、非対応なら止めてくれたらよかったのに、というのが率直な感想です。

    WordPress標準の更新処理に独自の事前チェックを入れる難しさはあるのかもしれません。
    それでも、データベースのような重要な部分を扱うプラグインには、失敗したときの安全性も期待したいところです。

    MariaDBに戻すだけ、のはずだった

    以前使っていたMariaDBへ接続を戻せばいい、と最初は考えました。

    SQLite Database Integrationを無効化すれば、WordPressは以前のMySQL/MariaDBへ再接続できます。
    ただし、SQLiteで運用していた間の更新データは、MariaDBへ自動同期されません。
    そのまま戻すと、古い状態のサイトになってしまいます。

    できればSQLを手作業でいじるようなことはしたくありませんでした。
    バックアップ・復元プラグインでSQLite側のデータを保存して、MariaDB側へ復元できれば終わり。
    そう考えて、UpdraftPlusやAll-in-One WP Migrationなど、いろいろなプラグインを試しました。

    SQLiteに対応しているとされるものもありましたが、SQLiteをバックアップできることと、MariaDBへ復元できることは別問題。
    試した範囲では、MariaDBへの移行を最後まで完了できるものを見つけられませんでした。
    サーバー側のSQLiteのバージョンとの相性も関係していたのかもしれませんが、原因までは切り分けられていません。

    結局、SQLiteからSQLを取り出してMariaDB向けに変換。
    テスト用データベースで試し、作業中に更新されたデータとの差分も確認してから本番に反映しました。

    最終的に54テーブルを移行し、WordPressのサイトヘルスでMariaDB 10.11.18に接続していることを確認。
    GitHub Actionsや変換スクリプトを用意して検証を繰り返す、なかなか大がかりな作業になりました。

    SQLiteは今でも好きだけど

    今回の経験でSQLiteが嫌いになったわけではありません。
    小規模なアプリなどでは、これからも積極的に使いたいと思っています。
    エックスサーバーも、WordPressをMariaDBで動かす分には引き続き便利なサービスです。

    ただ、両方を組み合わせて使うなら、PHPのバージョンだけでなく、実際に`pdo_sqlite`が使用するSQLiteライブラリのバージョンも見ておく必要があります。
    今は動いていても、プラグイン側の更新で要件が変わる可能性があります。

    そして何より、導入前に、やめるときのことを確認しておくべきだった。

    SQLiteのファイルをバックアップできることと、そのデータを別のデータベースへ移せることは同じではありません。
    これはCMSに限らず、クラウドサービスなどを選ぶときにも言えることだと思います。

    導入が簡単だからといって、出口まで簡単とは限らない。
    今回はそれを身をもって知ることになりました。


    この記事は筆者のブログ記事をnote向けに再構成したものです。SQLiteのバージョン条件や、エックスサーバー環境での判断については元記事にもまとめています。

    https://happas.jp/blog/xserver-wordpress-sqlite-caution-ja

     
     

    kodo

     
     
    きのむくままに、つくったり、かいたり、いろいろやってみています。 https://happas.jp/

    あなたへのおすすめ