Laravel: could not find driver — в PHP нет модуля для базы данных
Laravel работает с базой данных через модуль PHP — драйвер PDO. Для каждой базы он свой: для MySQL, PostgreSQL и SQLite. Ошибка could not find driver значит, что нужного модуля в PHP нет. Его ставят одним пакетом и перезапускают PHP-FPM.
Содержание 10
Что сделать прямо сейчас
- Посмотрите в тексте ошибки, какая база нужна: после
Connection:стоитmysql,mariadb,pgsqlилиsqlite. - Поставьте пакет для этой базы — таблица ниже. Для MySQL:
sudo apt install php8.3-mysql. - Перезапустите PHP-FPM:
sudo systemctl restart php8.3-fpm. - Обновите страницу сайта.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в именах пакетов и команд вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.
Как выглядит ошибка
could not find driver (Connection: mysql, Host: 127.0.0.1, Port: 3306, Database: laravel, SQL: select * from `sessions` where `id` = … limit 1)| Часть | Что значит |
|---|---|
could not find driver | «драйвер не найден» — так отвечает PHP, когда нужного модуля PDO нет |
Connection: mysql | какое подключение из настроек Laravel использовалось |
Host, Port, Database | куда Laravel подключался |
SQL: … | какой запрос Laravel хотел выполнить |
Запрос к таблице sessions в примере — не причина ошибки. В новом проекте Laravel сессии посетителей хранятся в базе, поэтому до базы Laravel обращается на любой странице.
Для SQLite в тексте нет Host и Port: could not find driver (Connection: sqlite, Database: /var/www/example.com/database/database.sqlite, SQL: …).
Ошибка видна на странице, если в файле .env стоит APP_DEBUG=true, и в журнале storage/logs/laravel.log. В терминале её покажет, например, php artisan migrate.
Какой пакет поставить
Какая база выбрана, задаёт строка DB_CONNECTION в файле .env в папке проекта:
grep '^DB_CONNECTION=' .env| DB_CONNECTION | Модуль PHP | Пакет в Ubuntu 24.04 |
|---|---|---|
mysql или mariadb | pdo_mysql | php8.3-mysql |
pgsql | pdo_pgsql | php8.3-pgsql |
sqlite | pdo_sqlite | php8.3-sqlite3 |
В новом проекте Laravel стоит DB_CONNECTION=sqlite. Если вы не меняли .env, нужен пакет php8.3-sqlite3.
Установка, например для MySQL:
sudo apt update
sudo apt install php8.3-mysqlПакет php8.3-mysql ставит сразу три модуля: mysqli, mysqlnd и pdo_mysql. Пакет php8.3-pgsql — pgsql и pdo_pgsql, пакет php8.3-sqlite3 — sqlite3 и pdo_sqlite.
Чтобы модуль увидел и сайт
Модуль ставится и для командной строки, и для PHP-FPM, но работающий PHP-FPM узнает о нём только после перезапуска:
sudo systemctl restart php8.3-fpmПроверьте, что модуль есть в обоих местах:
php -m | grep -i pdo
php-fpm8.3 -m | grep -i pdoПервая команда показывает модули PHP для командной строки — с ними работает php artisan. Вторая — модули PHP-FPM, с ними работает сайт. В ответе должна быть строка с вашим драйвером, например pdo_mysql.
Если на сервере несколько версий PHP
Пакет ставит модуль только для своей версии PHP. Если сайт работает на другой версии, модуль нужен для неё.
Какие версии стоят, покажет ls /etc/php/. Какую версию использует сайт, видно в настройке fastcgi_pass в nginx: в пути к сокету стоит номер, например php8.3-fpm.sock. Как это устроено — в справочнике fastcgi_pass в nginx.
Команда php в терминале может оказаться другой версии, чем у сайта. Её версию покажет php -v.
Если пакет стоит, а модуля нет
Модуль могли выключить. Включите его и перезапустите PHP-FPM:
sudo phpenmod pdo_mysql
sudo systemctl restart php8.3-fpmВместо pdo_mysql — нужный модуль из таблицы. Если PHP при запуске пишет, что не может загрузить модуль, смотрите разбор Unable to load dynamic library.
Если драйвер есть, а база не подключается
Когда модуль на месте, Laravel идёт к базе. Если она не отвечает или не пускает, будет другая ошибка — со словами SQLSTATE. Разбор — на странице Laravel: SQLSTATE[HY000] [2002].
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
could not find driver (Connection: mysql | нет модуля pdo_mysql | sudo apt install php8.3-mysql |
could not find driver (Connection: pgsql | нет модуля pdo_pgsql | sudo apt install php8.3-pgsql |
could not find driver (Connection: sqlite | нет модуля pdo_sqlite | sudo apt install php8.3-sqlite3 |
| в терминале работает, на сайте ошибка | PHP-FPM не перезапущен или другая версия PHP | перезапустите PHP-FPM |
| пакет стоит, модуля нет | модуль выключен | sudo phpenmod |
SQLSTATE[HY000] [2002] | драйвер есть, база не отвечает | Разбор |
Composer пишет ext-… is missing from your system | нет модуля, который требует пакет | Разбор |
Текст сообщения сверен по исходному коду PHP 8.3.6 и Laravel 13.42.0, имена пакетов — по каталогу пакетов Ubuntu 24.04.
Источники
- Пакет php8.3-mysql в Ubuntu 24.04 — на английском: описание и список файлов модулей.
- Пакет php8.3-pgsql в Ubuntu 24.04 — на английском.
- Пакет php8.3-sqlite3 в Ubuntu 24.04 — на английском.
- Документация Laravel: Database — на английском: настройки подключения и DB_CONNECTION.
- Исходный код QueryException в Laravel — на английском: как к тексту ошибки добавляются Connection, Host и SQL.
- Исходный код PDO в PHP 8.3.6 — на английском: текст could not find driver.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- Как установить PHP на Ubuntuкакие версии PHP есть и как ставить модули.
- Composer: ext-… is missing from your systemесли модуль требует Composer.