WC Vendors 2.7.0アップグレードでfatal errorが出た時の対処法

WC Vendors 2.7.0アップグレードでfatal errorが出た時の対処法

WC Vendors 2.7.0 にアップグレードした直後、サイト全体が「このサイトで重大なエラーが発生しました」の表示になり管理画面にもアクセスできなくなった場合、wcvendors_capability_product_types オプションの値が配列ではなく文字列で保存されていることが原因だ。WP-CLI を使えるかどうかで復旧手順を分けて対処する。

WC Vendors 2.7.0で管理画面にすら入れなくなる原因は何か

この問題は、プラグイン内部の関数 wcv_is_all_product_types_hidden() が array_diff() を呼び出す際、引数として文字列を渡してしまうことで発生する。PHP 8 環境では型宣言が厳密になったため、ここで TypeError（致命的エラー）が起こり、サイト全体が HTTP 500 エラーで停止する。

関数に渡されるのは wcvendors_capability_product_types というオプションの値だ。このオプションは本来、商品タイプの配列（['simple', 'variable'] など）を保持すべきだが、古いバージョンの WC Vendors（特に 1.x 系）から移行してきたサイトでは、内部的に「simple」のような文字列のまま残っているケースがある。2.7.0 で追加された新しい関数には配列へのキャスト処理が含まれておらず、長期間眠っていた不正なデータが一気に致命的エラーとして表面化した。

エラーのトリガーは wp_loaded フックで、これは WordPress の読み込みのかなり早い段階で実行される。そのため管理画面もフロントエンドも一切表示されず、ダッシュボードからプラグインを無効化するという通常の復旧手段が使えなくなってしまう。

管理画面にログインできない場合の応急処置（WP-CLI を使う）

サーバーに SSH でアクセスできる環境であれば、WP-CLI を使って不正なオプション値を直接修正するのが最も確実な回復方法だ。管理画面に入れなくても、この操作でサイトは即座に復旧する。

wp option update wcvendors_capability_product_types '["simple"]' --format=json

上記コマンドは wcvendors_capability_product_types オプションの値を強制的に JSON 配列として上書きする。["simple"] の部分は、自サイトで実際に有効にしていた商品タイプのスラッグに置き換える。可変商品や外部商品を使っていた場合は、["simple","variable","external"] のようにカンマ区切りで列挙する。値は連想配列ではなく、単純なリスト形式でなければならない。

WP-CLI を使えない場合のエラー復旧手順（FTP/ファイルマネージャー）

レンタルサーバーでは SSH が利用できず、WP-CLI も使えないケースが多い。その場合は FTP またはサーバー付属のファイルマネージャーを使ってプラグインを一時的に無効化し、管理画面にアクセスできる状態に戻す。

1. FTP クライアントまたはファイルマネージャーで /wp-content/plugins/ ディレクトリにアクセスする
2. wc-vendors ディレクトリを探し、名前を wc-vendors-disabled に変更する
3. ブラウザで管理画面の URL（yourdomain.com/wp-admin/）を開く
4. 管理画面にログインできたら、wc-vendors-disabled をもとの wc-vendors に戻す（ただし有効化はしない）
5. 管理画面の「プラグイン」で WC Vendors が「無効」になっていることを確認し、データベースの該当オプションを修正する手順に進む

ディレクトリ名の変更によってプラグインが強制的に無効化される仕組みを利用している。ファイル自体は削除せず、リネームするだけなので元に戻せる。管理画面に戻ったら、次のセクションで説明する根本的なオプション修正を行う。現時点で WC Vendors を再度有効化すると、同じエラーが再発するので有効化してはいけない。

根本的な修正をプラグインのアップデート前に済ませておく

WC Vendors の開発チームはこの問題を認識しており、将来のリリースで修正が反映される見込みだ。しかしアップデートを待つだけでは、同じサイトで別の箇所が再び同様のエラーを起こす可能性を抱えたままになる。管理画面にログインできる状態にしたら、データベース上のオプション値を正規化してしまおう。

最も簡便な方法は、先ほど WP-CLI で実行したコマンドと同じ操作を、データベース管理ツール（phpMyAdmin など）やカスタムスクリプトで行うことだ。具体的には wp_options テーブルを開き、option_name が wcvendors_capability_product_types の行を探す。option_value カラムが文字列（例 simple）になっている場合、a:1:{i:0;s:6:"simple";} のようにシリアライズされた配列表現に書き換える。

PHP のシリアライズ形式を手書きするのはミスが怖い場合は、次のような安心な手順をとる。

1. WC Vendors が無効化されていることを確認する
2. 管理画面の「設定」→「WC Vendors」→「販売」→「商品タイプ」に進み、チェックボックスで適切な商品タイプを選んで保存する（これで正常な配列としてオプションが上書きされる）
3. WC Vendors を有効化する

この方法は管理画面を使うため、データベースを直接触る必要がなく安全だ。ただしバージョン 2.7.0 では有効化した瞬間に wp_loaded フックのエラーが再発する可能性があるため、あらかじめプラグインファイルの該当行を一時的に修正するか、前述のキャストを適用しておくと確実だ。

よくある質問

エラーログを確認するにはどうすればよいか

サーバーのエラーログには wp-content/debug.log（WordPress のデバッグログ）や、Apache/Nginx のエラーログがある。WP-CLI が使えれば wp config set WP_DEBUG true --raw と wp config set WP_DEBUG_LOG true --raw でログ出力を有効にした上で、エラーを再現させて wp-content/debug.log を確認する。共有サーバーではホスティングの管理画面からエラーログが見られることも多い。

WC Vendors をアップグレードする前に何か注意すべきことはあるか

メジャーバージョンアップを行う場合は、本番サイトに適用する前に必ずステージング環境でテストする。どうしても本番で行うなら、事前にデータベースのバックアップを取り、wcvendors_capability_product_types オプションの現在の値を確認しておく。WP-CLI で wp option get wcvendors_capability_product_types --format=json を実行し、値が配列形式になっていることを確かめればリスクを大幅に減らせる。

PHP のバージョンが 7.x 系ならこの問題は起きないか

PHP 7.x では array_diff() に文字列を渡しても Warning は出るが Fatal Error にはならないため、サイトが完全停止することはない。ただしエラー自体の根本原因は同じであり、動作は予期しない結果になる可能性が高い。推奨される PHP のバージョンは 8.x 系へ移行することであり、その前に対処しておくことが望ましい。

WC Vendors Free と Pro のどちらでも発生するのか

この問題は WC Vendors の無料版（Free）のコア機能部分で発生している。Pro 版を併用している場合でも、同じオプション値を読み込むため影響を受ける可能性が高い。特に 1.x 系からバージョンを重ねてきたサイトは要注意だ。

この記事のポイント

• WC Vendors 2.7.0 へのアップグレードでサイトが停止するのは array_diff() の型不一致が原因
• 古いサイトでは wcvendors_capability_product_types が文字列で残っているケースがある
• WP-CLI を使えるなら wp option update で即座に復旧できる
• WP-CLI が使えない場合はプラグインディレクトリをリネームして管理画面に復帰する
• 根本的には設定画面で商品タイプを保存し直すか、データベースの値を配列に正規化する

佐々木 太陽

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている