Обработка MySQL ошибок в PHP коде

Расширенные примеры отладки MySQL ошибок в PHP

Пример 1: PDO с разными режимами ошибок (сравнение)

Рассмотрим три режима: ERRMODE_SILENT (по умолчанию), ERRMODE_WARNING и ERRMODE_EXCEPTION. Код и результат для ошибочного запроса:

$dsn = 'mysql:host=localhost;dbname=test;charset=utf8';
$pdo = new PDO($dsn, 'root', '');

// 1. SILENT
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
$result = $pdo->query('SELECT invalid_column FROM users');
if (!$result) {
    echo 'Ошибка в тихом режиме: ' . $pdo->errorCode() . "\n";
} // Вывод: Ошибка в тихом режиме: 42S22

// 2. WARNING
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
$result = $pdo->query('SELECT invalid_column FROM users');
// Вывод предупреждения на экран (если display_errors включен)
// Warning: PDO::query(): SQLSTATE[42S22]: ...

// 3. EXCEPTION
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
try {
    $pdo->query('SELECT invalid_column FROM users');
} catch (PDOException $e) {
    echo 'Исключение: ' . $e->getMessage() . "\n";
} // Вывод: Исключение: SQLSTATE[42S22]: Column not found: ...

Ошибка в тихом режиме: 42S22
Исключение: SQLSTATE[42S22]: Column not found: 1054 Unknown column 'invalid_column' in 'field list'

Для продакшена часто выбирают ERRMODE_WARNING с логированием или ERRMODE_EXCEPTION с глобальным обработчиком.

Пример 2: mysqli с подготовленными запросами и детальным отловом ошибок

Использование mysqli_report с исключениями позволяет перехватывать ошибки даже в подготовленных запросах, которые могут вернуть false при неудачной подготовке.

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$conn = new mysqli('localhost', 'root', '', 'test');

try {
    $stmt = $conn->prepare('SELECT * FROM users WHERE email = ?');
    $stmt->bind_param('s', $email);
    $email = 'test@example.com';
    $stmt->execute();
    $result = $stmt->get_result();
    while ($row = $result->fetch_assoc()) {
        print_r($row);
    }
} catch (mysqli_sql_exception $e) {
    echo 'Ошибка MySQL: ' . $e->getMessage() . ' (код ' . $e->getCode() . ')';
}
// Если таблица 'users' не существует, будет выброшено исключение с сообщением
// 'Table 'test.users' doesn't exist'

Ошибка MySQL: Table 'test.users' doesn't exist (код 1146)

Примечание: код ошибки (1146) можно использовать для выборочной обработки.

Пример 3: Логирование ошибок с дополнительным контекстом (файл, строка, SQL)

Для детального логирования полезно передавать в лог не только сообщение, но и текст запроса, вызвавшего ошибку.

function logSqlError(PDOException $e, $sql) {
    $message = sprintf(
        "[%s] SQL Error: %s in file %s on line %d\nQuery: %s\n",
        date('Y-m-d H:i:s'),
        $e->getMessage(),
        $e->getFile(),
        $e->getLine(),
        $sql
    );
    error_log($message, 3, '/var/log/mysql_errors.log');
}

$sql = "INSERT INTO logs (data) VALUES ('test')";
try {
    $pdo->exec($sql);
} catch (PDOException $e) {
    logSqlError($e, $sql);
    echo 'Операция не выполнена. Пожалуйста, свяжитесь с администратором.';
}

(Файл /var/log/mysql_errors.log появится с записью типа)
[2025-03-18 12:30:00] SQL Error: SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry 'test' for key 'data' in file /var/www/html/index.php on line 15
Query: INSERT INTO logs (data) VALUES ('test')

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

Пример 4: Глобальный обработчик ошибок для PDO и MySQL

Можно установить пользовательский обработчик исключений, который перехватывает все PDOException и отправляет их в единый лог-сервис.

set_exception_handler(function (Throwable $e) {
    if ($e instanceof PDOException) {
        // Запись в файл
        error_log('PDO Exception: ' . $e->getMessage());
        // Отправка в Sentry (пример)
        // \Sentry\captureException($e);
        // Вывод пользователю
        echo 'Произошла ошибка базы данных. Мы уже работаем над её исправлением.';
    } else {
        // Для других исключений - стандартное поведение
        throw $e;
    }
});

// Теперь любой необработанный PDOException попадёт в этот обработчик
$pdo->query('SELECT * FROM nonexistent');

(На экране отобразится сообщение:)
Произошла ошибка базы данных. Мы уже работаем над её исправлением.

Этот подход позволяет централизованно управлять всеми ошибками MySQL, не прописывая try-catch в каждом месте.

Пример 5: Обработка ошибок при работе с кодировкой (charset)

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

// Ошибочное соединение (без charset)
$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// Запрос с русскими символами может привести к ошибке или неправильному результату
try {
    $pdo->exec("INSERT INTO users (name) VALUES ('Иван')");
} catch (PDOException $e) {
    echo 'Ошибка вставки: ' . $e->getMessage() . "\n";
}
// Возможная ошибка: 'Incorrect string value' (SQLSTATE[22007])

// Исправление - указать charset в DSN
$dsn = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
$pdo = new PDO($dsn, 'root', '');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->exec("INSERT INTO users (name) VALUES ('Иван')");

(При первом варианте - сообщение об ошибке, при втором - успешная вставка)
Ошибка вставки: SQLSTATE[22007]: Invalid datetime format: 1366 Incorrect string value: '\xD0\xB8...'

Рекомендуется всегда указывать utf8mb4 для полной поддержки Unicode.