Как исправить ошибку 'could not find driver' в PHP настройках окружения

Расширенные примеры установки и диагностики драйверов PDO

Ниже приведены сценарии для различных окружений и операционных систем, включая нестандартные случаи.

Пример 1. Скрипт полной диагностики PDO

Этот скрипт показывает, какие драйверы доступны, версию PHP, конфигурационные директивы, связанные с PDO, и проверяет наличие конкретного драйвера.

<?php
echo "Версия PHP: " . phpversion() . "
";
echo "Доступные драйверы PDO: " . implode(', ', PDO::getAvailableDrivers()) . "
";
echo "Загруженные расширения PDO: " . implode(', ', get_loaded_extensions(true)) . "
";
// Проверка наличия pdo_mysql
if (in_array('pdo_mysql', get_loaded_extensions(true))) {
    echo "pdo_mysql загружен.";
} else {
    echo "pdo_mysql НЕ загружен.";
}
?>

Результат (пример вывода):

Версия PHP: 8.1.23
Доступные драйверы PDO: mysql, sqlite
Загруженные расширения PDO: Core, date, libxml, pdo, pdo_mysql, spl, standard
pdo_mysql загружен.

Если драйвер не загружен, проверьте php.ini или переустановите расширение.

Пример 2. Установка всех популярных драйверов PDO в Ubuntu одной командой

Для разработчика может потребоваться сразу несколько драйверов. Выполните:

sudo apt install php-mysql php-pgsql php-sqlite3 php-oci8 php-firebird

После установки проверьте через php -m | grep pdo. Обратите внимание, что расширения для Oracle и Firebird могут требовать дополнительные библиотеки (libaio1, firebird-dev).

Пример 3. Установка драйвера pdo_pgsql в Alpine Linux (маленький Docker-образ)

В официальных образах php:8.2-alpine часто используется apk:

FROM php:8.2-alpine
RUN apk add --no-cache postgresql-dev \
    && docker-php-ext-install pdo_pgsql

Если вы используете собственный образ, не забудьте установить postgresql-dev - это требуется для компиляции.

Пример 4. Включение драйвера pdo_mysql в php.ini для разных версий PHP (CLI и Apache)

Иногда бывает, что для CLI и веб-сервера используются разные php.ini. Для CLI:

# Показать путь:
php --ini
# Редактировать найденный файл, добавить строку (если её нет):
echo "extension=pdo_mysql" >> /etc/php/8.1/cli/php.ini

Для Apache (если используется mod_php):

# Узнать путь через phpinfo() или:
sudo nano /etc/php/8.1/apache2/php.ini
# Добавить extension=pdo_mysql

Затем перезапустите Apache:

sudo systemctl restart apache2

Пример 5. Использование PDO::getAvailableDrivers() для выбора подходящего подключения

В сложных приложениях можно динамически выбирать драйвер в зависимости от доступности:

<?php
$dsn = '';
$drivers = PDO::getAvailableDrivers();
if (in_array('mysql', $drivers)) {
    $dsn = 'mysql:host=localhost;dbname=test';
} elseif (in_array('sqlite', $drivers)) {
    $dsn = 'sqlite:/tmp/test.sqlite';
} else {
    die('Нет доступного драйвера PDO');
}
try {
    $pdo = new PDO($dsn, 'user', 'pass');
    echo 'Подключение успешно';
} catch (PDOException $e) {
    echo 'Ошибка: ' . $e->getMessage();
}
?>

Пример 6. Компиляция PHP с собственными драйверами PDO (продвинутый уровень)

Если стандартные пакеты не подходят, можно скомпилировать PHP с необходимыми опциями:

./configure --with-pdo-mysql=/usr \
            --with-pdo-pgsql=/usr \
            --with-pdo-sqlite=shared \
            --with-pdo-oci=instantclient,/usr/lib/oracle/21/client64/lib
make -j4
sudo make install

После сборки проверьте, что расширения загружаются:

php -m | grep pdo

При сборке могут возникнуть ошибки отсутствующих заголовочных файлов (например, mysql.h). Установите пакеты -dev перед конфигурацией.

Пример 7. Исправление ошибки 'could not find driver' для pdo_sqlite на Windows без установки SQLite

В состав PHP обычно входит расширение php_pdo_sqlite.dll. Если оно не загружается, проверьте наличие DLL в папке ext. Если файла нет, скачайте PHP снова с включённым расширением. Также убедитесь, что в php.ini не стоит ;extension=php_pdo_sqlite.dll. После исправления перезапустите сервер.

Пример 8. Использование composer для проверки необходимых расширений

В вашем composer.json можно указать требуемые расширения. При установке пакетов Composer проверяет их наличие. Если расширение отсутствует, он выдаст ошибку. Пример composer.json:

{
    "require": {
        "php": ">=8.0",
        "ext-pdo_mysql": "*",
        "ext-pdo_pgsql": "*"
    }
}

Запустите composer install - если расширение не установлено, вы получите сообщение о недостающем требовании.