【Laravelエラー】could not find driver（Windows, MySQL編）

編集

この記事の要点

Laravel から MySQL に接続するための PHP 拡張 pdo_mysql が読み込まれていないときのエラー
対処: php.ini の ;extension=pdo_mysql の先頭の ; を外し、php artisan serve や Apache を再起動する
php.ini の場所は php --ini で確認。「Loaded Configuration File: (none)」なら php.ini 自体が無い
Windows では extension_dir が正しく設定されていないと、行を有効にしても拡張が読み込まれない
コマンドライン用と Web サーバー用で別の php.ini が使われていることがある
php -m の一覧に pdo_mysql が出れば解決

前提

OS: Windows 10 / 11
DB: MySQL（MariaDB も同じ pdo_mysql 拡張を使います）
PHP: 公式サイト（windows.php.net）の ZIP 版、または XAMPP 同梱の PHP

エラー内容

could not find driver

Laravel のバージョンによっては、次のように接続情報付きで表示されます。

Illuminate\Database\QueryException
could not find driver (Connection: mysql, SQL: select * from ...)

発生条件と原因

php artisan migrate の実行時や、DB にアクセスするページを開いたときなど、MySQL に接続する際に発生するエラーです。

Laravel は PHP の PDO（データベース接続の共通インターフェース）を使って DB に接続します。PDO で MySQL を扱うには、pdo_mysql という拡張モジュールが必要です。Windows 版 PHP には pdo_mysql の DLL（ext\php_pdo_mysql.dll）は同梱されていますが、php.ini で有効にしないと読み込まれません。php.ini の該当行がコメントアウトされたままだと、PDO が MySQL 用のドライバーを見つけられずにこのエラーになります。

対処法

1. 使われている php.ini の場所を確認する

php.ini の場所は以下のコマンドで確認します（出力は一例です）。

$ php --ini
Configuration File (php.ini) Path: C:\Windows
Loaded Configuration File:         C:\Program Files\php-7.4.6-Win32-vc15-x64\php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed:      (none)

「Loaded Configuration File」に表示されたファイルが、実際に読み込まれている php.ini です。ここが (none) になっている場合は php.ini が存在しません。PHP のフォルダにある php.ini-development をコピーして php.ini という名前で保存してください。

2. pdo_mysql を有効にする

php.ini に「;extension=pdo_mysql」の記述があるので、先頭の「;」を削除してコメントアウトを解除します。

; 変更前
;extension=pdo_mysql

; 変更後
extension=pdo_mysql

PHP 7.2 より前のバージョンでは extension=php_pdo_mysql.dll という書き方になっています。Laravel と組み合わせるなら、mbstring、openssl、fileinfo なども同様に有効になっているか確認しておくと、後の別エラーを防げます。

3. extension_dir を設定する（Windows で特に重要）

Windows では、拡張モジュールを探すフォルダ extension_dir が実際の ext フォルダを指していないと、行を有効にしても読み込まれません。php.ini の該当行を、PHP をインストールしたフォルダの ext を指す絶対パスにしておくのが確実です。

extension_dir = "C:\Program Files\php-7.4.6-Win32-vc15-x64\ext"

4. PHP を使っているプロセスを再起動する

php.ini は PHP の起動時に読み込まれます。php artisan serve を使っている場合は Ctrl + C で止めて起動し直します。Apache（XAMPP）や IIS を使っている場合は、Web サーバーを再起動します。

これで MySQL にアクセスできるようになります。

直らないときに確認すること

状況	原因と対処
コマンドでは直ったがブラウザでは同じエラー	Web サーバーが別の php.ini を読んでいる。`phpinfo()` を表示するページを作り、「Loaded Configuration File」を確認して、そちらも修正する
PHP が複数インストールされている	`where php` で、コマンドプロンプトがどの php.exe を使っているか確認する。PATH の先頭にある PHP が使われる
起動時に「Unable to load dynamic library」の警告	extension_dir の指定が間違っているか、DLL が無い。警告に表示されたパスを確認する
エラーに Connection: sqlite と出ている	Laravel 11 以降の初期設定は SQLite。MySQL を使うなら .env の `DB_CONNECTION=mysql` に変える。SQLite を使うなら pdo_sqlite を有効にする
Docker やレンタルサーバーで発生	Windows 以外では php.ini ではなくパッケージの追加が必要なことが多い（例: Docker 公式イメージでは `docker-php-ext-install pdo_mysql`）

確認方法

読み込まれている拡張モジュールの一覧に pdo_mysql があるか確認します。

php -m | findstr /i pdo

pdo_mysql と表示されれば有効になっています。最後に php artisan migrate などを実行して、エラーが出ないことを確認しましょう。なお、ドライバーが読み込まれた後に「Access denied」や「Connection refused」が出る場合は、拡張の問題は解決しており、.env の接続設定や MySQL の起動状態の問題です。

ページ一覧

その他