概要
- テスト環境で構築したWordpressを本番環境の別サーバーに引っ越したら、一部のページが「重大なエラーが発生しました」と表示されてしまうエラーに悩まされました。2日くらい消費したので、どなたかの一助になればと思い、まとめておきます。
- Wordpressのサイトヘルスで「1つ以上の必須モジュールが存在しません」というエラーも出ていたので、そちらに直面している方にも参考になるかもです。
環境
- Mac
- 機種ID:MacBookPro18,3
- macOS:Monterey
- チップ:Apple M1 Pro
- メモリ:16GB
- サーバー(AWS EC2インスタンス)
- OS:Ubuntu 18.04.3 LTS
- Web Server:Apache/2.4.29
- Wordpressバージョン:6.1.1
- PHPバージョン:7.4.33
前提
- 上記サーバー情報は、テスト環境でも本番環境でも同じ。
- 変なプラグインはなし(WordPress ImporterとContact Form 7しか有効化されていない)。
- 変なテーマは利用していない。推奨PHPバージョンは7.4以上で、テスト環境では正常に機能している。
- テスト環境でWordpressを無事に構築できたので以下の順序でWordpressを引っ越し。
- 構築手順の記事はこちら:WordpressをEC2インスタンスにインストールする方法(Apacheのバーチャルホスト設定方法・Wordpress用DB作成方法も解説)
- Wordpress管理画面の「ツール」から「全てのコンテンツ」をエクスポート(XMLファイル)
- 本番環境のWordpress管理画面でWordpress Importerを利用してインポート
- テスト環境と同じ有料テーマをアップロード
- アップロードサイズエラーが出た際はこちら:【Wordpress】アップロード時の"upload_max_filesize"エラーと"Unable to create directory"エラーを対応
- 有料テーマを利用しているので、テスト環境のテーマオプション管理からエクスポートしたJsonファイルをインポート
- ちなみに、他にもプラグインを使って引っ越しする方法がありますが、データ破損のリスクやアップロードサイズ上限、課金制度などがあったので、やめました。ちょっとトライしましたが、アップロードサイズのところがうまくできんかった。
エラー内容
- テスト環境と同じくサクッと構築できると思ったら、なぜか一部ページで「重大なエラーが発生しました」が表示されてしまいました。
- えぇぇ!?こりゃ焦るやつや
- phpmyadminに入ろうとしてもこんな画面になってしまう。
- テスト環境では難なくできたのに...サイトヘルスをチェックすると以下のように表示されています。
- 「1つ以上の必須モジュールが存在しません」というエラーは、PHP拡張モジュールがインストールされていないことが原因のよう。
- サイトヘルスの「情報」タブをクリックすると、imagickやgdが利用できないことがわかります。おそらくこの辺に問題があることはなんとなく分かりますね。
やってみたこと
- 以下を実施しましたが、いずれもダメでした。
不足しているモジュールをインストール
- 存在しないと言われているモジュールをapt installで一個ずつ普通にインストール
$ sudo apt-get install php-gd
-
php -m
でモジュールが有効なことは確認できるが、エラーは変わらず
php.ini
で拡張機能を有効化する
- いろいろな記事に、PHPの設定ファイル
php.ini
で有効化する(拡張機能が正しくロードされるように設定する)必要がある、と記載があったので、/etc/php/7.4/apache2
にあるphp.ini
に各モジュールの有効化を記載します。- 元から
;
でコメントアウトされている場合は外すでもOK
- 元から
extension=curl.so
extension=imagick.so
extension=mbstring.so
extension=zip.so
extension=gd.so
extension=intl.so
- Apache再起動してみる。しかし、、、結果は変わらず。
- ちなみに、
apache2
だけでなくcli
やfpm
直下にあるphp.ini
にも追記してみたけど何も変化なし。-
/etc/php/7.4/apache2
にあるphp.ini
:Apache Webサーバーを使用してPHPスクリプトを実行する場合に読み込まれる設定ファイル -
/etc/php/7.4/cli
にあるphp.ini
:PHPコマンドラインインターフェース(CLI)を使用してPHPスクリプトを実行する場合に読み込まれる設定ファイル - →どちらも記載は必要だと思いますが、Apacheは2回読み込むことになるのか、以下のエラーログが吐き出されていました。PHPが各モジュールをすでに読み込んでいるので、同じ場所で再度読み込まれている、というメッセージですね。
-
PHP Warning: Module 'curl' already loaded in Unknown on line 0
PHP Warning: Module 'gd' already loaded in Unknown on line 0
PHP Warning: Module 'imagick' already loaded in Unknown on line 0
PHP Warning: Module 'intl' already loaded in Unknown on line 0
PHP Warning: Module 'mbstring' already loaded in Unknown on line 0
PHP Warning: Module 'zip' already loaded in Unknown on line 0
- 特に問題があるわけではないと思いますが、複数回読み込まれるログが鬱陶しい場合は
/etc/php/7.4/apache2
のみに記載でOKです。(本件解決後、自分の場合はそれで動いています)
デバッグモードで確認
-
wp-config.php
でデバッグモードを追記
define( 'WP_DEBUG', false )
- Apacheを再起動、エラーページを見てみるが、「重大なエラー」だけで、何も出てこない。
- 次に、
wp-config.php
でデバッグエラーログを吐き出させるよう設定する
define( 'WP_DEBUG_LOG', true )
- 中身を見てみるとほとんど有料テーマ関連の警告ばかり。
PHP Notice: Undefined index: catch_font_type in...
- うーん、特にこれが問題ではなさそう(結果、やっぱり関係なかった)。
LoadModule php7_moduleを入れてみる・パーミッションを確認する
- PHPのバージョンとApacheを連携させる必要があるという記事もあったので、
LoadModule php7_module modules/libphp7.4.so
をApacheの設定ファイル/etc/apache2/apache2.conf
に入れてApache再起動してみるが、やはりだめ。 - 読み込みアクセス権限やパーミッション(ディレクトリのパーミッションは「755」にするなど)の問題かと思い、正常に動いているテスト環境のものと見比べたが、問題なし...。
- ど、どういうこと...(⌒-⌒; )
解決手順
- 調べてみると、apache2.4のエラーログがあるらしい。
/var/log/apache2
にあるerror.log
を見てみると、こんなエラーメッセージがずらずらと並んでいるではありませんか。これ、サイトヘルスのと同じモジュールだ。
PHP Warning: PHP Startup: Unable to load dynamic library 'gd.so' (tried: /usr/lib/php/20190902/gd.so (/usr/lib/php/20190902/gd.so: cannot open shared object file: No such file or directory), /usr/lib/php/20190902/gd.so.so (/usr/lib/php/20190902/gd.so.so: cannot open shared object file: No such file or directory)) in Unknown on line 0
- どうやら、
/usr/lib/php/20190902/
にお探しのファイルがない模様。-
/usr/lib/php/20190902
は、PHPの拡張モジュールが格納されているディレクトリのパスです。このディレクトリは、PHP 7.3.xバージョンでのデフォルトの拡張モジュールのインストール先として使用されているらしい(20190902は、PHPのビルド日)。しかし、ここを見てみても、確かにgd.so
とかzip.so
が無い。インストールは成功していたけど、PHP7.4が見にいっていないのかもしれない。
-
- 以下でまず
zip.so
がどこにいるのか探してみる。(zipでもgdでもどれでもいいけどzipで調べてみた)
$ sudo find / -name 'zip.so'
/usr/lib/php/20170718/zip.so
/usr/lib/php/20220829/zip.so
- あれ、お探しの
20190902
にはないぞ。 - 以下コマンドで
zip.so
のシンボリックリンクを置いてあげると、、
$ ln -s /usr/lib/php/20220829/zip.so /usr/lib/php/20190902/zip.so
- 今度は以下のようにエラーログに記載されていました。
PHP Warning: PHP Startup: Unable to load dynamic library 'zip.so' (tried: /usr/lib/php/20190902/zip.so (/usr/lib/php/20190902/zip.so: undefined symbol: _call_user_function_impl)
- エラー内容が微妙に変わってる。シンボリックリンクではうまく読み込めてないっぽい。とにかく正しくロードされていないことがわかる。
- ちなみに、CPコマンドでコピーしてあげても、最初のエラーと同じものが吐き出されるだけだった。
$ cp -i /usr/lib/php/20220829/zip.so /usr/lib/php/20190902/zip.so
- PHPのバージョンとzip拡張機能のバージョンが互換性がないのか?
- そんなことを調べていて目に入ったのが、以下のサイト。
- ここでは、7.0指定でインストールすると解決するというコメントがあります。
Something wrong with your configuration, but if you have root access, just install again the missing extensions. For PHP 7.0:
sudo apt-get install php7.0-intl
sudo apt-get install php7.0-soap
- 早速、自分の場合は7.4で実施しました。
sudo apt-get install php7.4-intl
sudo apt-get install php7.4-zip
sudo apt-get install php7.4-curl
sudo apt-get install php7.4-imagick
sudo apt-get install php7.4-gd
sudo apt-get install php7.4-mbstring
- その後、Apache再起動をすると、なんと見事サイトヘルスから消えました!!うおおおおお!!!
- 「重大なエラーが発生しました」と表示されていたページを開いたら、無事に表示されるようになっていました。
ヤッタァぁぁぁぁあ!!!!
結論
- 「重大なエラー」の正体は、Wordpressで必要なPHPモジュールが正常に読み込まれていないことでした。
- phpMyAdminのアクセスエラーもPHPのmbstring拡張機能が有効になっていないために発生していたので、その後アクセスしたら正常にログインできました。
- PHP7.4指定でインストールしてあげないと、Apacheがちゃんと見てくれないわけか。あのエラーログにもっと早く辿り着いていれば。
- 途中、何が原因なのか分からずVirtualHost設定を見たり、有料テーマの中に悪さしているものがあるのか見たりして、かなり遠回りをしてしまいました。困った時はやっぱりエラーログですね。とにかく時間を使ったエラー対応でしたが、サイトヘルスが良好になった瞬間は感動しました...。ググっても大体「インストール」「php.ini」ばかりなので、今回このようにまとめらることでエンジニア同士の一助になれば幸いです。