Поиск
Ошибки

Laravel: could not find driver — в PHP нет модуля для базы данных

Laravel работает с базой данных через модуль PHP — драйвер PDO. Для каждой базы он свой: для MySQL, PostgreSQL и SQLite. Ошибка could not find driver значит, что нужного модуля в PHP нет. Его ставят одним пакетом и перезапускают PHP-FPM.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Посмотрите в тексте ошибки, какая база нужна: после Connection: стоит mysql, mariadb, pgsql или sqlite.
  2. Поставьте пакет для этой базы — таблица ниже. Для MySQL: sudo apt install php8.3-mysql.
  3. Перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm.
  4. Обновите страницу сайта.

Команды вводятся на сервере: подключитесь к нему по 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 или mariadbpdo_mysqlphp8.3-mysql
pgsqlpdo_pgsqlphp8.3-pgsql
sqlitepdo_sqlitephp8.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_mysqlsudo apt install php8.3-mysql
could not find driver (Connection: pgsqlнет модуля pdo_pgsqlsudo apt install php8.3-pgsql
could not find driver (Connection: sqliteнет модуля pdo_sqlitesudo 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.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше