WordPressで「PHPのインストールにMySQL拡張機能が不足しているようです」というエラーを解決する方法は？

WordPressをインストールまたはロードしようとした際に、「PHPのインストールに、WordPressに必要なMySQL拡張機能が不足しているようです」というエラーが表示されたことがあるなら、あなたは一人ではありません。このMySQL拡張機能不足の WordPressエラーは サイトを完全に停止させ、一見すると途方に暮れてしまうかもしれません。

幸いなことに、ほとんどの場合、PHPのMySQLドライバまたはサーバー設定の問題です。適切な手順を踏めば、高度な技術知識がなくても解決できます。.

要約：MySQL拡張機能が見つからない場合：知っておくべきこと

• PHPがMySQLとの通信に必要なデータベースドライバを見つけられないため、WordPressの読み込みに失敗します。これはサーバーレベルで発生したPHP拡張機能の読み込みエラーです。.

• このエラーは通常、 PHPのアップグレード、サーバー移行、またはphp.iniファイルの設定ミスによって引き起こされ、WordPressサイトがすべての訪問者に対してアンロードされる状態になります。

• PHPでMySQLiまたはPDO_MySQL拡張機能を有効にすることで、ほとんどの場合問題は解決します。.

• サーバーレベルの変更がご自身の専門外である場合は、ホスティングプロバイダーに依頼すれば迅速に修正を適用してもらえます。.

WordPressで発生する「PHPインストールにMySQL拡張機能が不足しているようです」エラーの概要

このエラーは、PHPの設定で必要なMySQL拡張機能が欠落しているか無効になっているため、WordPressがデータベースに接続できない場合に発生します。.

WordPressのエラーメッセージは何を意味するのですか？

エラーメッセージ全文は次のとおりです。「お使いのPHPインストールには、WordPressに必要なMySQL拡張機能が不足しているようです。」

簡単に言うと、PHPがMySQLデータベースと通信するために必要なライブラリを見つけられないことが原因です。このPHP拡張機能の欠落により、 WordPressデータベースエラーが コンテンツが表示される前に

その接続がないと、WordPressはコンテンツ、設定、サイトの一部などを読み込むことができません。ウェブサイト全体にアクセスできなくなります。.

これはWordPressのバグではありません。サーバー側の問題です。WordPressは単に不足しているコンポーネントを検出し、それを報告しているだけです。.

MySQL拡張機能が見つからないというエラーメッセージの例

このエラーが発生すると、通常は真っ白な画面に以下のいずれかが表示されます。このWordPressの白い画面には、多くの場合、それ以上の説明はありません。

• 「お使いのPHPインストールには、WordPressに必要なMySQL拡張機能が不足しているようです。」

• 「MySQLに接続できませんでした。」

• 「データベースを選択できません。」

これらのメッセージは通常、WordPressの管理画面が読み込まれる前に表示されます。また、WordPressを新規インストールした際に、セットアップスクリプトがデータベースに接続できない場合にも、このエラーが表示されることがあります。.

なぜこのエラーがWordPressウェブサイトを破壊するのか？

WordPressは完全にデータベース駆動型です。ページが読み込まれるたびに、PHPクエリがMySQLデータベースに対して実行されます。WordPressのMySQL接続が切断されると、WordPressは以下のいずれも実行できなくなります。

• 投稿、ページ、カテゴリ、またはコメントを取得します。.
• 現在アクティブなテーマの設定とウィジェット構成を読み込みます。.
• ユーザーログインを認証する。.
• インストールされているプラ​​グインの機能を実行します。.

その結果、ウェブサイトは全く機能しなくなります。訪問者はコンテンツではなく、エラー画面を目にすることになります。.

PHP、MySQL、およびWordPressデータベース接続の関係

PHPはWordPressを動かすスクリプト言語です。MySQLは、サイトのすべてのデータ、投稿、ユーザー、設定、 プラグインデータなどを保存するリレーショナルデータベースです。

これら2つのシステムは、橋渡し役となるPHP拡張機能を介して通信します。WordPressは、データベース抽象化レイヤーであるwpdbクラスを通して、この処理を内部的に行います。.

訪問者がサイトにアクセスするたびに、PHPはwpdbクラスを介してMySQLにクエリを送信し、関連データを取得して、結果をHTMLページとして返します。この通信に必要なPHP拡張機能が欠落しているか無効になっている場合、処理全体が失敗します。.

WordPressは起動時にこの拡張機能をチェックします。何も見つからない場合は、すぐに「MySQL拡張機能が見つかりません」というエラーを表示します。.

MySQL、MySQLi、PDO MySQLの違いを解説します

PHPの拡張機能のうち、MySQLデータベース接続を処理できるものは3つあります。

• MySQL：オリジナルのPHP MySQL拡張機能です。PHP 5.5で非推奨となり、PHP 7.0で完全に削除されました。WordPressも同時にサポートを終了しました。サーバーがPHP 7.0以降で動作している場合（通常はそうであるべきですが）、この拡張機能は利用できません。長期的に使用することは最初から選択肢として適切ではありませんでした。

• MySQLi：改良版のMySQL拡張機能（「i」は改良版を意味します）。PHPでは、php.iniファイルまたはホスティングコントロールパネルからMySQLiを有効にできます。オブジェクト指向プログラミングと手続き型プログラミングの両方をサポートし、プリペアドステートメントや複数ステートメントなどの機能も追加します。WordPressは、MySQLiが利用可能な場合、デフォルトでこれを使用します。

• PDO_MySQL：PHPデータオブジェクトは、より抽象的なデータベースインターフェースです。単一の一貫したAPIを通じて、複数のデータベースシステムをサポートします。WordPressは、MySQLiが利用できない場合の代替手段としてPDO_MySQLを使用できます。

最新のWordPressでは、MySQLiまたはPDO_MySQLのいずれかがインストールされ、有効になっている必要があります。どちらもインストールされていない場合、MySQL拡張機能が見つからないというエラーがすぐに表示されます。.

WordPressで発生する「MySQL拡張機能が見つかりません」というエラーの原因は何ですか？

このエラーは、いくつかの異なる状況で発生する可能性があります。根本原因を特定することが、適切な解決策を見つけるための第一歩です。.

• PHP アップグレード時の拡張機能引き継ぎなし PHP を PHP 7.4 から PHP 8.1 または 8.2 にアップグレードする場合、新しい PHP インストールには、以前有効だったすべての拡張機能が自動的に含まれない場合があります。php-mysqli パッケージは、多くの場合、別途再インストールする必要があります。MySQLi 拡張機能は、以前のインストールでは有効だったにもかかわらず、新しいインストールには含まれない可能性があります。これは、本番環境でこのエラーが発生する最も一般的な原因の 1 つです。

• サーバー移行： WordPressサイトを 新しいサーバーに移行したり、 ホスティングプロバイダーを 、PHP環境の設定が誤ってしまう可能性があります。すべてのサーバー構成でMySQLiがデフォルトで有効になっているわけではありません。新しいサーバーでは、MySQLiなしでPHPが実行される場合があります。

• php.ini ファイルの破損または不完全性 php.ini ファイルは、どの拡張機能をロードするか、また extension_dir ディレクティブを介して PHP が拡張機能を探す場所など、PHP 環境のあらゆる側面を制御します。このファイルが破損している、不完全である、または正しい MySQLi 拡張機能の行が欠落している場合、PHP は起動エラーをスローし、WordPress は必要なドライバを見つけることができません。

• 複数のPHPバージョンが同時に実行されている場合。 一部のサーバーでは、複数のPHPバージョンが並行して実行されています。WordPressがMySQLiが欠落している誤ったPHPバイナリを参照している場合、同じサーバー上の他のサイトは正常に動作していても、このエラーが表示されます。ホスティングコントロールパネルには正しいバージョンが表示されていても、Webサーバーが別のバージョンを使用している場合があるため、このPHPバージョンの競合は見落とされやすいです。

• カスタムサーバーへの新規インストール： XAMPP、MAMP、Laragon、Dockerコンテナなどのカスタム構成のローカルサーバーにWordPressを新規インストールする場合、デフォルトではMySQLiが有効にならないことがよくあります。ローカル環境をセットアップする開発者は、ほとんどのデフォルトのXAMPPおよびMAMP設定でphp-mysqli拡張機能を手動で有効にする必要があるため、この問題に頻繁に遭遇します。

• ホスティングプロバイダーによる設定変更： ホスティングプロバイダーは、 サーバー設定を 。これらの変更により、以前は有効だった拡張機能が意図せず無効になる場合があります。

WordPressで発生するMySQL拡張機能の欠落エラーを修正する方法

この問題は、MySQL拡張機能を有効にするか、PHPを更新するか、サーバーの設定を修正することで解決できます。.

方法1：PHPでMySQLi拡張機能をインストールまたは有効化する

というパッケージ名です php-mysqli ベースのシステムでは、

UbuntuまたはDebianの場合（php-mysqliをインストールしてください）：

sudo apt install php-mysqli sudo service apache2 restart

CentOSまたはRHELの場合：

sudo yum install php-mysqli sudo systemctl restart httpd

インストール後、ウェブサーバーを再起動してください。その後、WordPressサイトを再読み込みして、エラーが解消されたかどうかを確認してください。.

共有ホスティングをご利用の場合は、コントロールパネル（cPanel、Pleskなど）で「PHP拡張機能」または「PHP拡張機能の選択」セクションを探してください。 mysqli 有効化し、保存します。変更は通常すぐに反映されます。

方法2：PHPバージョンの確認とアップグレードまたはダウングレード

PHPのバージョンが互換性がないことがよくある原因です。WordPressは公式にPHP 8.1以降を推奨しています。.

サポートされていないバージョン、特にコア拡張機能が欠落しているバージョンを実行すると、このエラーが発生します。PHP 8.1とPHP 8.2は、適切に設定されたサーバーではデフォルトでMySQLiを含んでいます。.

PHPのバージョンを確認および変更するには：

• ホスティングコントロールパネルにログインしてください。.

• 「PHPバージョン」、「MultiPHPマネージャー」、または同様のオプションを探してください（cPanelでは、「ソフトウェア」の中にあります）。.

• PHP 8.1または8.2に切り替えてください。どちらのバージョンにもMySQLiがデフォルトで含まれています。.

最近のアップグレードでサイトが動作しなくなった場合は、調査中に一時的に以前のバージョンに戻すことができます。ホスティングサービスによっては、ドメインごとにPHPのバージョンを選択できる場合もあります。.

PHPのバージョン変更は、本番環境に適用する前に必ずステージングサイトでテストしてください。バージョンが一致しないと、データベースエラーが発生するだけでなく、プラグインやテーマが動作しなくなる可能性があります。.

方法3：WordPressのコア、テーマ、プラグインを更新する

古いコアファイル、 テーマ、またはプラグインは、PHPデータベース層の障害を含む互換性エラーを引き起こすことがあります。

内部データベース抽象化クラス（wpdb、新しいPHPバージョンやMySQLとの互換性要件に対応するため、

WordPressをアップデートするには：

• に移動してください 「ダッシュボード」→「更新情報」 管理パネルの
• をクリックしてください 今すぐアップデート」 WordPressコアをアップデートするには、「
• 次に、有効なプラグインとテーマをすべて更新してください。.

エラーが原因で管理パネルにアクセスできない場合は、WordPress.orgから直接ダウンロードした最新のWordPressファイルをFTP経由でアップロードして更新してください。これは、wp-contentフォルダに手を加えることなくコアファイルを安全に更新する方法です。.

アップデートを実行する前に、必ずサイト全体とデータベースのバックアップを取ってください。これにより、アップデート中に何らかの問題が発生した場合でもデータが保護されます。.

方法4：phpinfo()を使用してPHPの設定を確認する

phpinfo () 関数は、サーバーの PHP 環境に関する詳細なレポートを出力します。phpinfo() を実行して WordPress をチェックすることは、MySQLi または PDO_MYSQL がロードされているかどうかを確認する最も迅速な方法の 1 つです。

• という名前の新しいファイルを作成してください info.php WordPressのルートディレクトリに
• この一行を追加してください。 <?php phpinfo(); ?>
• にアクセスしてください yourdomain.com/info.php ブラウザで
• 出力結果から「mysqli」または「pdo_mysql」を検索するには、Ctrl+Fを使用してください。.

「mysqli」というタイトルのセクションが表示され、ステータスが有効になっている場合は、拡張機能がロードされています。表示されていない場合は、拡張機能が不足しているため、追加する必要があります。.

セキュリティに関する注意： 削除してください info.php 確認後、

方法5：php.iniの設定問題を修正する

php.ini ファイルは、起動時にどの PHP 拡張機能を読み込むかを決定します。拡張機能の行の先頭にコメント文字 (セミコロン) があると、その拡張機能は読み込まれません。探している行は extension=mysqli。

• FTPまたはSSH経由でサーバーにアクセスしてください。.
• php.ini ファイルを探してください。一般的なパスは /etc/php/8.1/apache2/php.ini または /etc/php.ini。
• という行を検索してください。 ;extension=mysqli」
• コメントを解除するにはセミコロンを削除してください: extension=mysqli
• ファイルを保存して、ウェブサーバーを再起動してください。.

ホスティングプロバイダがphp.iniへの直接アクセスを制限している場合は、 .user.ini WordPressのルートディレクトリに extension=mysqli 認識します .user.ini 。

方法6：複数のPHPバージョンの競合を解決する

複数のPHPバージョンが稼働しているサーバーでは、WordPressが誤ったバージョンに割り当てられる場合があります。そのバージョンにMySQLiがインストールされていない場合、エラーが発生します。.

これを解決するには:

• を使用して）サイトが使用しているPHPのバージョンを確認してください phpinfo() 方法4で説明されている

• cPanelで MultiPHP Manager 、ドメインに適切なPHPバージョンを割り当ててください。

• を開き 「PHP拡張機能の選択」 、 mysqli が有効になっていることを確認してください。

自己管理サーバーでは、 php -v アクティブなバージョンを確認し、php -m | grep mysqli を使用してそのバイナリに MySQLi がロードされているかどうかを確認します。php -m | grep mysqli が何も返さない場合、そのバージョンには拡張子がありません。

方法7：PHPと必要な拡張機能を再インストールする

MySQLiの有効化に失敗した場合は、PHPのインストール自体が破損している可能性があります。PHPとmysqliモジュールをクリーンインストールすることで解決できます。.

UbuntuまたはDebianの場合：

sudo apt purge php8.1 php8.1-mysql sudo apt install php8.1 php8.1-mysqli sudo service apache2 restart

CentOSまたはRHELの場合：

sudo yum remove php php-mysql sudo yum install php php-mysqli sudo systemctl restart httpd

再インストール後、 `php -m | grep mysqli` 、拡張機能が有効になっていることを確認してください。出力に「mysqli」が表示されるはずです。

方法8：サーバースタック構成（ApacheまたはNginxとMySQL）を確認する

ウェブサーバーは、PHPリクエストを適切なPHPインタープリタに正しくルーティングする必要があります。この設定ミスがあると、拡張機能がインストールされていても読み込まれない場合があります。.

• Apacheの場合： ことを確認してください mod_php または php-fpm 。Apache mod_phpは PHPをモジュールとして直接ロードしますが、PHP-FPMは別のプロセスとして実行されます。VirtualHostの設定を確認し、正しいPHPハンドラが割り当てられていることを確認してください。

• Nginxの場合： NginxはPHPをネイティブに実行しないため、常にPHP-FPMが必要です。 fastcgi_pass ディレクティブが正しいPHP-FPMソケットファイルを指していることを確認してください。PHP-FPMプールがMySQLiをサポートするバージョンで実行されていることを確認してください。

変更を加えた後は、WebサーバーとPHP-FPMの両方を再起動してください。

sudo systemctl restart nginx sudo systemctl restart php8.1-fpm

続きを読む： Apache vs Nginx：WordPressホスティングにはどちらが優れているか

方法9：ホスティングプロバイダーに問い合わせてサポートを受ける

上記の方法がどれも難しすぎると感じる場合は、ホスティングプロバイダーに問い合わせるのが最も迅速な解決策です。ほとんどのマネージドWordPressホスティングサービスでは、標準サポートの一環としてPHP拡張機能の問題を数分以内に解決してくれます。.

サポートにお問い合わせの際は、以下の情報を含めてください。

• 表示されている正確なエラーメッセージです。.

• 現在サイトで使用されているPHPのバージョン（phpinfoまたはcPanelから確認できます）。.

• エラーが最初に発生したのは、アップデート、移行、またはサーバーメンテナンスの後でした。.

マネージドWordPressホスティングを提供するプロバイダーは、PHP拡張機能のサポートを含め、サーバーレベルのPHP設定をユーザーに代わって処理します。.

共有ホスティングの場合、サポートチームはお客様による操作を一切必要とせずに、サーバー側からMySQLiを有効にすることができます。.

WordPressにおけるMySQL拡張機能の欠落エラーに関する高度なトラブルシューティング

上記の標準的な方法でエラーが解決しない場合は、これらの高度な手法が問題箇所の特定に役立ちます。.

wp-config.php ファイルを確認してください。MySQLi がインストールされていても、wp-config.php ファイルに誤ったデータベース認証情報が含まれていると、接続できません。wp -config.php 、以下のデータベース設定を確認してください。

define( 'DB_NAME', 'your_database_name' ); define( 'DB_USER', 'your_database_username' ); define( 'DB_PASSWORD', 'your_database_password' ); define( 'DB_HOST', 'localhost' );

これらのフィールドのいずれかに誤った値が入力されている場合、特に DB_HOSTにが入力されている場合、一見すると拡張子が見つからないエラーのように見えるエラーが発生する可能性があります。

の代わりに特定のホスト名を使用している場合があり localhost、誤った値を使用すると、MySQLi が正しくインストールされている場合でも接続がブロックされます。

WordPressのデバッグモードを有効にします。 に以下の行を追加してください wp-config.php 。WP_DEBUG_LOGは、エラーを公開表示するのではなく、すべてのエラーをファイルに保存します。

定義( 'WP_DEBUG', true ); 定義( 'WP_DEBUG_LOG', true ); 定義( 'WP_DEBUG_DISPLAY', false );

WP_DEBUG_LOG ファイルは wp-content/debug.log。このファイル内で、PHP 拡張機能に関連するメッセージや PHP の起動エラーを探してください。mysqli_connect 、、 未定義関数の呼び出し拡張機能の問題を直接示しています。

サーバーのエラーログを確認してください。Apache に保存します /var/log/apache2/error.log。Nginx は /var/log/nginx/error.log。これらのサーバーエラーログには、PHP 拡張機能の読み込みに失敗した正確な理由（共有ライブラリの欠落、 extension_dir パスの誤り、拡張機能の読み取りを妨げるファイル権限の問題など）が記録されていることがよくあります。

セキュリティソフトウェアの競合を確認してください。Web アプリケーションファイアウォール（WAF）、サーバーレベルのウイルス対策ツール、および強力なWordPressセキュリティプラグインは、PHP拡張機能の読み込みを妨害したり、データベースハンドシェイク要求をブロックしたりすることがあります。これらのツールを一時的に無効にして、再度テストしてください。エラーが解消された場合は、セキュリティツールが原因でした。セキュリティツールを再度有効にし、データベース接続ポート（通常は3306）をホワイトリストに追加して、競合のない保護機能を復元してください。

ステージング環境でテストしてください。 サーバーレベルの変更を本番サイトに直接適用してテストすることは絶対に避けてください。修正を本番環境に展開する前に、ステージング環境を使用して適用および検証を行ってください。ほとんどのマネージドホスティングプロバイダーは、プランの一部としてステージング環境を提供しています。

WordPressでMySQL拡張機能のエラーを防ぐためのベストプラクティス

予防は、復旧よりも常に費用もストレスも少なくて済みます。これらの対策を講じることで、WordPressサイトでこのエラーが発生する可能性を低減できます。.

• PHPを常に最新の状態に保ち、WordPressの要件に準拠させてください。WordPress の最新の推奨事項（2024～2025年時点ではPHP 8.1以上）に合致するPHPバージョンを常に使用してください。PHPをアップグレードする際は、必要な拡張機能、MySQLi、およびPDO_MySQLがすべて新しいインストールに明示的に含まれていることを確認してください。アップグレードを行う前に、必ずWordPressの公式PHP要件ページを確認してください。

• PHPのアップグレードはステージングサイトでテストしてください。 本番サイトでPHPを更新する前に、ステージング環境で新しいバージョンを実行してください。PHP Compatibility Checkerプラグインなどのツールを使用して、WordPressのPHP互換性テストを実施してください。変更を本番環境に反映させる前に、MySQLiが正しくロードされ、すべてのプラグインとテーマが互換性を維持していることを確認してください。

• マネージドWordPressホスティングを利用しましょう。 マネージドホスティングプロバイダーは、サーバーレベルのPHP設定を自動的に処理します。PHPとその拡張機能を常に最新の状態に保ち、正しく設定することで、この種のエラーが発生するリスクを大幅に軽減します。

• 定期的なサイトバックアップを維持してください。WordPress ファイルとデータベースの両方の最新バックアップを常に保持してください。サーバーの変更によってこのエラーが発生した場合、バックアップがあれば、根本原因を修正している間、正常に動作する状態に戻すことができます。

• 稼働状況監視でサイトを常に監視しましょう。WordPress のリアルタイム稼働状況監視機能は、サイトがオフラインになった瞬間にアラートを発信します。ダウンタイムアラートがあれば、MySQL拡張機能のエラーを数時間ではなく数分以内に検知できます。ダウンタイムを最小限に抑えることで、訪問者、検索エンジンのランキング、そして収益を守ることができます。

• サーバー構成を文書化しましょう。 サーバーを自己管理している場合は、使用しているすべてのPHP拡張機能と構成の詳細な記録を残してください。この文書があれば、移行後や大規模なアップグレード後に環境を再現するのがはるかに容易になります。

• 定期的なWordPressメンテナンスを実施しましょう。 コア、プラグイン、テーマのアップデート、PHPバージョンのチェック、WordPressデータベースの最適化などを含む体系的なメンテナンスルーチンは、設定のずれを防ぎ、互換性の問題が本番サイトのエラーを引き起こす前に発見するのに役立ちます。通常のメンテナンス作業と併せて、PHP設定の月次レビューをスケジュールしましょう 。

最後に

「PHPのインストールにMySQL拡張機能が不足しているようです」というエラーは厄介ですが、解決可能です。ほとんどの場合、この問題はWordPressの問題ではなく、PHPの設定でMySQLi拡張機能が無効になっているか、あるいは存在しないことが原因です。つまり、PHPデータベース拡張機能の問題なのです。.

まずは最も簡単な方法から始めましょう。ホスティングコントロールパネルでMySQLiが有効になっているか確認し、有効になっていない場合は有効にしてください。それでも問題が解決しない場合は、PHPのバージョンを確認し、php.iniファイルに extension=mysqli、必要に応じてPHPを再インストールするなど、以下の手順を順番に試してください。

サーバーレベルの変更があなたの専門外である場合、ホスティングプロバイダーは通常、数分以内に解決してくれます。.

さらに重要なのは、このエラーの再発を防ぐための適切な環境を整えることです。PHPを常に最新の状態に保ち、マネージドWordPressホスティングを利用し、定期的なメンテナンスを実施しましょう。適切にメンテナンスされたWordPressサイトは、これらのエラーのほとんどを訪問者に届く前に回避し、万が一発生した場合でも迅速に復旧します。.

「PHP インストールに MySQL 拡張機能が見つからないようです」エラーの解決に関するよくある質問