Php pdo mysql ошибка

Ошибки и их обработка

PDO предлагает на выбор 3 стратегии обработки ошибок в зависимости от вашего
стиля разработки приложений.

  • PDO::ERRMODE_SILENT

    До PHP 8.0.0, это был режим по умолчанию. PDO просто предоставит вам код ошибки, который
    можно получить методами PDO::errorCode() и
    PDO::errorInfo(). Эти методы реализованы как в объектах
    запросов, так и в объектах баз данных. Если ошибка вызвана во время выполнения
    кода объекта запроса, нужно вызвать метод
    PDOStatement::errorCode() или
    PDOStatement::errorInfo() этого объекта. Если ошибка
    вызова объекта базы данных, нужно вызвать аналогичные методы у этого объекта.

  • PDO::ERRMODE_WARNING

    Помимо установки кода ошибки PDO выдаст обычное E_WARNING сообщение. Это может
    быть полезно при отладке или тестировании, когда нужно видеть, что произошло,
    но не нужно прерывать работу приложения.

  • PDO::ERRMODE_EXCEPTION

    Начиная с PHP 8.0.0 является режимом по умолчанию. Помимо задания кода ошибки PDO будет выбрасывать исключение
    PDOException, свойства которого будут отражать
    код ошибки и её описание. Этот режим также полезен при отладке, так как
    сразу известно, где в программе произошла ошибка. Это позволяет быстро
    локализовать и решить проблему. (Не забывайте, что если исключение
    является причиной завершения работы скрипта, все активные транзакции
    будут откачены.)

    Режим исключений также полезен, так как даёт возможность структурировать
    обработку ошибок более тщательно, нежели с обычными предупреждениями PHP, а
    также с меньшей вложенностью кода, чем в случае работы в тихом режиме с
    явной проверкой возвращаемых значений при каждом обращении к базе данных.

    Подробнее об исключениях в PHP смотрите в разделе Исключения.

PDO стандартизирован для работы со строковыми кодами ошибок SQL-92 SQLSTATE.
Отдельные драйверы PDO могут задавать соответствия своих собственных кодов
кодам SQLSTATE. Метод PDO::errorCode() возвращает одиночный
код SQLSTATE. Если необходима специфичная информация об ошибке, PDO предлагает
метод PDO::errorInfo(), который возвращает массив, содержащий
код SQLSTATE, код ошибки драйвера, а также строку ошибки драйвера.

Пример #1 Создание PDO объекта и установка режима обработки ошибок


<?php
$dsn
= 'mysql:dbname=testdb;host=127.0.0.1';
$user = 'dbuser';
$password = 'dbpass';$dbh = new PDO($dsn, $user, $password);
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);// PDO выбросит исключение PDOException (если таблица не существует)
$dbh->query("SELECT wrongcolumn FROM wrongtable");
?>

Результат выполнения данного примера:

Fatal error: Uncaught PDOException: SQLSTATE[42S02]: Base table or view not found: 1146 Table 'testdb.wrongtable' doesn't exist in /tmp/pdo_test.php:10
Stack trace:
#0 /tmp/pdo_test.php(10): PDO->query('SELECT wrongcol...')
#1 {main}
  thrown in /tmp/pdo_test.php on line 10

Замечание:

Метод PDO::__construct() будет всегда бросать исключение PDOException,
если соединение оборвалось, независимо от установленного значения PDO::ATTR_ERRMODE.

Пример #2 Создание экземпляра класса PDO и установка режима обработки ошибок в конструкторе


<?php
$dsn
= 'mysql:dbname=test;host=127.0.0.1';
$user = 'googleguy';
$password = 'googleguy';$dbh = new PDO($dsn, $user, $password, array(PDO::ATTR_ERRMODE => PDO::ERRMODE_WARNING));// Следующий запрос приводит к ошибке уровня E_WARNING вместо исключения (когда таблица не существует)
$dbh->query("SELECT wrongcolumn FROM wrongtable");
?>

Результат выполнения данного примера:

Warning: PDO::query(): SQLSTATE[42S02]: Base table or view not found: 1146 Table 'test.wrongtable' doesn't exist in
/tmp/pdo_test.php on line 9

There are no user contributed notes for this page.

    $st = $db->prepare("SELECT * FROM c6ode");

How can I check the intentional mysql error for the query in above case?

Your Common Sense's user avatar

asked Jan 8, 2012 at 8:41

TPSstar's user avatar

0

You need to set the error mode attribute PDO::ATTR_ERRMODE to PDO::ERRMODE_EXCEPTION.

And since you expect the exception to be thrown by the prepare() method, you should disable the PDO::ATTR_EMULATE_PREPARES feature. Otherwise the MySQL server doesn’t «see» the statement until it’s executed.

<?php
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8', 'localonly', 'localonly');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
$pdo->prepare('INSERT INTO DoesNotExist (x) VALUES (?)');

prints (or logs, depends on the PHP settings)

SQLSTATE[42S02]: Base table or view not found: 
1146 Table 'test.doesnotexist' doesn't exist

Your Common Sense's user avatar

answered Jan 8, 2012 at 8:52

VolkerK's user avatar

VolkerKVolkerK

95.2k20 gold badges163 silver badges226 bronze badges

1

I’m using this without any additional settings:

if (!$st->execute()) {
    print_r($st->errorInfo());
}

The Codesee's user avatar

The Codesee

3,6945 gold badges38 silver badges74 bronze badges

answered Jan 8, 2012 at 8:48

ladar's user avatar

ladarladar

5,8562 gold badges26 silver badges38 bronze badges

0

I’m guessing that your complaint is that the exception is not firing. PDO is most likely configured to not throw exceptions. Enable them with this:

$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); 

answered Jan 8, 2012 at 8:45

Steve Rukuts's user avatar

Steve RukutsSteve Rukuts

9,1273 gold badges49 silver badges72 bronze badges

2

a quick way to see your errors whilst testing:

$error= $st->errorInfo();
echo $error[2];

answered Jan 15, 2014 at 11:19

Lan's user avatar

LanLan

1,8742 gold badges20 silver badges37 bronze badges

0

/* Provoke an error — the BONES table does not exist */

$sth = $dbh->prepare('SELECT skull FROM bones');
$sth->execute();

echo "nPDOStatement::errorInfo():n";
$arr = $sth->errorInfo();
print_r($arr);

output

Array
(
    [0] => 42S02
    [1] => -204
    [2] => [IBM][CLI Driver][DB2/LINUX] SQL0204N  "DANIELS.BONES" is an undefined name.  SQLSTATE=42704
)

answered Jul 5, 2017 at 9:07

Timothy Nwanwene's user avatar

1

Вернуться к: PDO

PDO предлагает на выбор 3 стратегии обработки ошибок в зависимости от вашего
стиля разработки приложений.

  • PDO::ERRMODE_SILENT

    Это режим по умолчанию. PDO просто предоставит вам код ошибки, который
    можно получить методами PDO::errorCode() и
    PDO::errorInfo(). Эти методы реализованы как в объектах
    запросов так и в объектах баз данных. Если ошибка вызвана во время выполнения
    кода объекта запроса, нужно вызвать метод
    PDOStatement::errorCode() или
    PDOStatement::errorInfo() этого объекта. Если ошибка
    вызова объекта базы данных, нужно вызвать аналогичные методы у этого объекта.

  • PDO::ERRMODE_WARNING

    Помимо задания кода ошибки PDO выдаст обычное E_WARNING сообщение. Это может
    быть полезно при отладке или тестировании, когда нужно видеть, что произошло,
    но не нужно прерывать работу приложения.

  • PDO::ERRMODE_EXCEPTION

    Помимо задания кода ошибки PDO будет выбрасывать исключение
    PDOException, свойства которого будут отражать
    код ошибки и ее описание. Этот режим также полезен при отладке, так как
    сразу известно, где в программе произошла ошибка. Это позволяет быстро
    локализовать и решить проблему. (Не забывайте, что если исключение
    является причиной завершения работы скрипта, все активные транзакции
    будут откачены.)

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

    Подробнее об исключениях в PHP см. в разделе Исключения.

PDO стандартизирован для работы со строковыми кодами ошибок SQL-92 SQLSTATE.
Отдельные PDO драйверы могут задавать соответствия своих собственных кодов
кодам SQLSTATE. Метод PDO::errorCode() возвращает одиночный
SQLSTATE код. Если необходима специфичная информация об ошибке, PDO предлагает
метод PDO::errorInfo(), который возвращает массив, содержащий
SQLSTATE код, код ошибки драйвера, а также строку ошибки драйвера.

Пример #1 Создание PDO объекта и задание режима обработки ошибок


<?php
$dsn 
'mysql:dbname=testdb;host=127.0.0.1';
$user 'dbuser';
$password 'dbpass';

try {

$dbh = new PDO($dsn$user$password);
    
$dbh->setAttribute(PDO::ATTR_ERRMODEPDO::ERRMODE_EXCEPTION);
} catch (
PDOException $e) {
    echo 
'Подключение не удалось: ' $e->getMessage();
}
?>

Замечание:

Метод PDO::__construct() будет всегда бросать исключение PDOException,
если соединение оборвалось, независимо от установленного значения PDO::ATTR_ERRMODE.
Непойманные исключения фатальны.

Пример #2 Создание экземпляра класса PDO и задание режима обработки ошибок в конструкторе


<?php
$dsn 
'mysql:dbname=test;host=127.0.0.1';
$user 'googleguy';
$password 'googleguy';/*
    По прежнему оберните конструктор в блок try/catch, так как, даже при установке ERRMODE в WARNING,
    PDO::__construct всегда будет бросать исключение PDOException, если соединение оборвалось.
*/
try {
    
$dbh = new PDO($dsn$user$password, array(PDO::ATTR_ERRMODE => PDO::ERRMODE_WARNING));
} catch (
PDOException $e) {
    echo 
'Соединение оборвалось: ' $e->getMessage();
    exit;
}
// Следующий запрос приводит к ошибке уровня E_WARNING вместо исключения (когда таблица не существует)
$dbh->query("SELECT wrongcolumn FROM wrongtable");
?>

Результат выполнения данного примера:

Warning: PDO::query(): SQLSTATE[42S02]: Base table or view not found: 1146 Table 'test.wrongtable' doesn't exist in
/tmp/pdo_test.php on line 18

Вернуться к: PDO

В этой статье разговор пойдет о PHP Data Objects (PDO) — расширение для PHP, предоставляющее разработчику универсальный интерфейс для доступа к различным базам данных.

В чем преимущество PDO? Этот вопрос можно раскрыть тремя пунктами:

  • Универсальный интерфейс для работы с различными базами данных. Разработчик может легко перевести свое веб-приложение на другую СУБД, поменяв при этом всего пару строк кода.
  • Высокая скорость работы.
  • Подготовленные выражения, о которых мы поговорим чуть позже.

На данный момент расширение PDO может поддерживать СУБД для которой существует PDO-драйвер:

  • PDO_CUBRID (CUBRID)
  • PDO_DBLIB (FreeTDS, Microsoft SQL Server, Sybase)
  • PDO_FIREBIRD (Firebird, Interbase 6)
  • PDO_IBM (IBM DB2)
  • PDO_INFORMIX (IBM Informix Dynamic Server)
  • PDO_MYSQL (MySQL 3.x/4.x/5.x)
  • PDO_OCI (Oracle Call Interface)
  • PDO_ODBC (ODBC v3 (IBM DB2, unixODBC and win32 ODBC))
  • PDO_PGSQL (PostgreSQL)
  • PDO_SQLITE (SQLite 3 and SQLite 2)
  • PDO_SQLSRV (Microsoft SQL Serve )
  • PDO_4D (4D)

Подключение к базе данных

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

// MуSQL
$DBH = new PDO("mysql:host=$host;dbname=$dbname", $user, $pass); 

// PostgreSQL
$DBH = new PDO("pgsql:host=$host;dbname=$dbname", $user, $pass);

//MS SQL
$DBH = new PDO("mssql:host=$host;dbname=$dbname", $user, $pass); 

// SQLite
$DBH = new PDO("sqlite:my/database/path/database.db");

Обработка ошибок и исключения

Обязательно заключайте подключение к базе данных в блок try/catch:

try {
    $DBH = new PDO("mysql:host=$host;dbname=$dbname", $user, $pass); 
} 
catch(PDOException $e) { 
    echo "Нет соединения с базой данных"; 
}

Иначе, в случае ошибки, в браузер будет выкинут Fatal error, в котором будут раскрыты все подробности вашего соединения, с логином и паролем.

PDO умеет выбрасывать исключения при ошибках, поэтому все операции с базой, по хорошему, должны находиться в блоке try/catch.

PDO имеет три режима обработки исключения:

  • PDO::ERRMODE_SILENT — режим по умолчанию, ошибки генерируются по такому же принципу, как в расширениях mysql или mysqli. После возникновения ошибки скрипт продолжит работу.
  • PDO::ERRMODE_WARNING — режим вызовет стандартное сообщение E_WARNING и позволит скрипту продолжить работу.
  • PDO::ERRMODE_EXCEPTION — режим выбрасывает исключение, что позволяет обрабатывать ошибки и скрывать важную информацию от посторонних глаз.

Чтобы установить необходимый уровень контроля ошибок необходимо вызвать метод $this->setAttribute после подключения к базе данных.

try {
    $DBH = new PDO("mysql:host=$host;dbname=$dbname", $user, $pass); 
    $DBH->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} 
catch(PDOException $e) { 
    echo "Нет соединения с базой данных"; 
}

Подготовленные выражения или Prepared Statements

Подготовленные выражения — это заранее скомпилированное SQL-выражение, которое может быть многократно выполнено путем отправки серверу лишь различных наборов данных. Дополнительным преимуществом является невозможность провести SQL-инъекцию.

За подготовленные выражения отвечает метод $DBH->prepare. Им и рекомендуется всегда пользоваться.

Сразу хочу отметить, что выполнить запрос в PDO можно тремя методами:

  • $DBH->exec — используется для запросов, которые не возвращают никаких данных. Метод возвращает количество затронутых им записей, или FALSE в случае ошибки.
$count_row = $DBH->exec("DELETE FROM users");
  • $DBH->query – используется выполнения не защищенных запросов, и возвращает результат или FALSE в случаи ошибки. Например, им можно выполнять простые запросы.
$DBH->query("SET NAMES 'cp1251'");
$DBH->query("SELECT * FROM users");
$DBH->query("DELETE FROM users");
  • $DBH->prepare + $STH->execute — используется для подготовки выражений и выполнения запроса.
// безымянные placeholders
$STH = $DBH->prepare("INSERT INTO users (name, phone, city) values (?, ?, ?)");
// именные placeholders
$STH = $DBH->prepare("INSERT INTO users (name, phone, city) values (:name, :phone, :city)");

После подготовки, запрос выполняется методом $STH->execute($data).

// безымянные placeholders

$data = array();
$data[] = 'Alersander';
$data[] = '+7 000 123 45 67';
$data[] = 'St. Petersburg';

$STH = $DBH->prepare("INSERT INTO users (name, phone, city) values (?, ?, ?)");
$STH->execute($data);
// именные placeholders

$data = array();
$data['name'] = 'Alersander';
$data['phone'] = '+7 000 123 45 67';
$data['city'] = 'St. Petersburg';

$STH = $DBH->prepare("INSERT INTO users (name, phone, city) values (:name, :phone, :city)");
$STH->execute($data);

Выборка данных

Для выборки с произвольными параметрами тоже будем использовать метод $DBH->prepare. Данные выборки можно получить с помощью методов:

  • $STH->fetch — выбирает следующую строку и возвращает в необходимом виде.
  • $STH->fetchAll — возвращает массив всех выбранных строк.
  • $STH->fetchObject — выбирает следующую строку и возвращает ее как объект.

Я буду рассматривать только первый метод, т.к. он универсальный и предоставляет разработчику, всё, что ему необходимо.

Методу $STH->fetch можно указать, в каком виде нам нужно предоставить результат:

  • PDO::FETCH_BOTH (по умолчанию) — возвращает числовой и ассоциативный массив;
  • PDO::FETCH_ASSOC — возвращает массив ассоциативный с названиями столбцов;
  • PDO::FETCH_NUM — возвращает массив числовыми ключами в виде порядковых номеров столбцов;
  • PDO::FETCH_OBJ — возвращает анонимный объект со свойствами, соответствующими именам столбцов;
  • PDO::FETCH_BOUND — присваивает значения столбцов соответствующим переменным, заданным с помощью метода $STH->bindColumn();
  • PDO::FETCH_CLASS — присваивает значения столбцов соответствующим свойствам указанного класса. Если для какого-то столбца свойства нет, оно будет создано;
  • PDO::FETCH_INTO — обновляет существующий экземпляр указанного класса;
  • PDO::FETCH_LAZY — объединяет в себе PDO::FETCH_BOTH и PDO::FETCH_OBJ.
$STH = $DBH->prepare("SELECT name, phone, city FROM users");
$STH->execute();

while($res = $STH->fetch(PDO::FETCH_ASSOC)) {
    echo $res['name'];
}

$STH = $DBH->prepare("SELECT name, phone, city FROM users");
$STH->execute();

while($res = $STH->fetch(PDO::FETCH_OBJ)) {
    echo $res->name;
}

Закрытие соединения и освобождение буфера запроса

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

$DBH = null;
$STH = null;

Полезные методы

  • $DBH->lastInsertId() — возвращает id последней вставленной записи.
  • $DBH->query(string) — экранирует специальные символы в строковых данных таким образом, что их становится безопасно использовать в запросах.
  • $STH->rowCount() — возвращает количество затронутых записей последним запросом.

Обработка ошибок PDO

Лично мне не нравится, что если я не заключаю все запросы в блок try/catch, то PDO выкидывает Fatal error со всеми интимными подробностями моего запроса. В промышленном приложении заключать каждый запрос в блок try/catch, это идиотизм!

Поэтому мы поступим следующим образом — немного расширим классы PDO и PDOStatement:

class DB extends PDO
{
    public $error = false; // выводить сообщения об ошибках на экран? (true/false)
    
    public function __construct($dsn, $username='', $password='', $driver_options=array()) {
        try {
            parent::__construct($dsn, $username, $password, $driver_options);
                
            $this->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
            $this->setAttribute(PDO::ATTR_STATEMENT_CLASS, array('DBStatement', array($this)));
            
            $this->query("SET NAMES 'cp1251'");
        } catch(PDOException $e) { 
            echo "Произошла ошибка в работе с базой данных...";
            exit();
        }
    }
    
    public function prepare($sql, $driver_options=array()) {
        try {
            return parent::prepare($sql, $driver_options);
        } catch(PDOException $e) { 
            $this->error($e->getMessage());
        }
    }
    
    public function query($sql) {
        try {
            return parent::query($sql);
        } catch(PDOException $e) { 
            $this->error($e->getMessage());
        }
    }
    
    public function exec($sql) {
        try {
            return parent::exec($sql);
        } catch(PDOException $e) { 
            $this->error($e->getMessage());
        }
    }
    
    public function error($msg) {
        if($this->error) {
            echo $msg;
        } else {
            echo "Произошла ошибка в работе с базой данных...";
        }
        exit();
    }
}
class DBStatement extends PDOStatement 
{
    protected $DBH;
    
    protected function __construct($DBH) {
        $this->DBH = $DBH;
    }
    
    public function execute($data=array()) {
        try {
            return parent::execute($data);
        } catch(PDOException $e) {
            $this->DBH->error($e->getMessage());
        }
    }
}

Как видите, я реализую свои два класса DB и DBStatement, наследуя классы PDO и PDOStatement. Классы реализуют все необходимые мне для работы над ошибками методы, которые обрабатываются блоком try/catch.

$DBH = new DB("mysql:host=$host;dbname=$dbname", $user, $pass);
$DBH->error = true; // Для отладки выводим сообщения об ошибках на экран.

$STH = $DBH->prepare("SELEC * FROM users");
$STH->execute($data);

Как видите, я совершил опечатку в операторе и могу получить всю необходимую информацию об этой ошибке.

SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error in your SQL syntax; 
check the manual that corresponds to your MySQL server version for the right syntax to use near 
'SELEC * FROM users' at line 1

Расширение функционала

Также бывает полезно расширить функционал PDO. Например, часто требуется получить количество записей в таблице.

Стандартными методами это можно делать следующим образом:

$data = array();
$data['user_id'] = 1;

$STH = $DBH->prepare("SELECT COUNT(*) as count FROM users WHERE user_id=:user_id");
$STH->execute($data);
        
echo $STH->fetch(PDO::FETCH_OBJ)->count;

Не слишком удобно. Поэтому реализуем в нашем классе методом count:

class DB extends PDO
{
    // ..................

    public function count($sql, $data)
    {
        $res = $this->prepare($sql);
        $res->execute($data);
        
        return $res->fetch(PDO::FETCH_OBJ);
    }

    // ..................
}

Получаем количество записей:

$DBH = new DB("mysql:host=$host;dbname=$dbname", $user, $pass);
echo $DBH->count("SELECT COUNT(*) as count FROM users WHERE user_id=:user_id", array('user_id'=>'1'))->count;

Свои методы это конечно хорошо, но мне бы ещё хотелось писать все одной строкой. К сожалению, стандартными возможностями я не могу этого сделать:

$res = $DBH->prepare("SELECT * FROM users WHERE id_user=:id_user")
           ->execute(array('id_user'=>'1'))
           ->fetch(PDO::FETCH_ASSOC);
echo $res['name'];

// или так
echo $DBH->prepare("SELECT *FROM users WHERE id_user=:id_user")
         ->execute(array('id_user'=>'1'))
         ->fetch(PDO::FETCH_OB)
         ->name;

Метод execute возвращает бесполезное логическое значение об успехе операции, а не объект DBStatement.

Допиливаем свой метод execute:

public function execute($data=array())
{
    try {
        parent::execute($data);
        return $this; 
    } 
    catch(PDOException $e) {
        $this->DBH->error($e->getMessage());
    }
}

Проверяем результат:

echo $DBH->prepare("SELECT COUNT(*) as count FROM users WHERE city=:city")
         ->execute(array('city'=>'St. Petersburg'))
         ->fetch(PDO::FETCH_OBJ)
         ->count;

Источник

Каталог оборудования

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Производители

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Функциональные группы

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

The first step is to switch on exceptions. When bootstrapping PDO, make sure to do:

$opts = [
  PDO::ATTR_ERRMODE                  => PDO::ERRMODE_EXCEPTION,
  PDO::ATTR_DEFAULT_FETCH_MODE       => PDO::FETCH_BOTH,
  PDO::ATTR_EMULATE_PREPARES         => false,
  PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false
];

$dbh = new PDO(
  "mysql:host=$host;port=$port;dbname=$name;charset=utf8",
  $user,
  $pass,
  $opts
);

Every time you execute a PDO statement using PDOStatement::execute.

There is a possiblity of an exception being raised.

use PDOException;

try {
  $sth = $dbh->prepare('...');
  $sth->execute();
} catch (PDOExcepton $e) {
  var_dump($e->getCode());
  var_dump($e->getMessage());
  var_dump($e->errorInfo);
}

In the above we demonstrate the 3 most important methods and properties of the exception object.

The returned getCode() gives back a 5 character SQLSTATE code string. This is defined as part of the SQL standard and is meant to be generic across databases. For more information on this code: https://en.wikibooks.org/wiki/Structured_Query_Language/SQLSTATE

The returned getMessage() is a string construced by PDO which has a format of:

SQLSTATE[XXXXX]: DESCRIPTION: YYYY MESSAGE

Where XXXXX is the SQLSTATE code, DESCRIPTION is a PHP supplied description like Syntax error or access violation or <<Unknown error>>, YYYY is the driver specific code, and finally the MESSAGE is the driver returned message.

Driver specific codes are usually more specific than the SQLSTATE code, so you can pattern match on driver specific code in order to dig down to more specific errors. For example this is the list of MySQL driver error codes and how they match to SQLSTATE codes: https://dev.mysql.com/doc/refman/en/error-messages-server.html and here’s the one for MariaDB: https://mariadb.com/kb/en/mariadb/mariadb-error-codes/

It is possible to create custom SQLSTATE codes to use for schema-specific errors that your application should handle. In MySQL, you should use the DECLARE ... CONDITION syntax to give human readable names to your custom error codes. Custom error codes should avoid conflicting with existing error codes. The standard SQL specification says that classes beginning with 0, 1, 2, 3, 4, A, B, C, D, E, F and G are reserved for standard-defined classes, while other classes are vendor-specific. It also says that, when the class is standard-defined, subclasses starting with those characters (except for ‘000’) are standard-defined subclasses, while other subclasses are vendor-defined. So depending on your database, look for a range that isn’t used now and unlikely to be used in the future. Here’s an example use: 50000 for general application errors, and then start at 50001 for specific errors.

I have not found good documentation on what kind of PHP supplied descriptions are available. You can use it as kind of summary description of the error. However you have to use regex to extract it from the message string as it is not discretely provided by other means.

When you use database triggers to enforce constraints, you will probably use the 45000 SQLSTATE code, you can pattern match on 45000 to know whether it’s a trigger error or otherwise.

In order to do pattern matching easily, rather than using getMessage() or getCode(), you should instead use the errorInfo array. This provides the SQLSTATE code (still in string type), the driver specific code (in my MySQL tests, the type was integer), and the driver specific message. If you do pattern matching on the SQLSTATE code, your codebase will be somewhat more portable than pattern matching on the driver specific code.

Here is an example of pattern matching against the PDO errors. Make sure to read your database manual and know what kind of errors you’re interested in. Note that in PHP it’s possible to compare strings and integers for equality.

try {
  // ...
} catch (PDOException $e) {
  switch ($e->errorInfo[1]) {
  case 1062:
    error_log('Violating unique key constraint: ' . $e->errorInfo[2]);
  case 1644:
    // for mysql this is the same as matching on getCode() or errorInfo[0] using '45000'
    error_log('User Defined Error!: ' . $e->errorInfo[2]);
  default:
    throw $e;
  }
}

If the above code exists in some model, you can then rethrow and wrap the exception in a model specific exception, or handle the exception there exactly.

If you’re using an ORM that wraps the PDOException, you should always be able to get it using getPrevious().

Handling PDO exceptions properly, can allow a clean propagation of errors from the database to the frontend of a web application, as this allows you to keep the constraints on data where the data lives and is ultimately managed. Then we avoid having to repeat validation logic from database to application.

However it may be even cleaner if the schema and constraints on the data were a commonly understood interface that was imported by frontend, backend and database, and validation code and database schema and database model operations can be automatically generated from the common schema. (Perhaps JSON Schema or schema.org or PostgREST might rescue us from CRUD hell?)

Понравилась статья? Поделить с друзьями:

Не пропустите эти материалы по теме:

  • Яндекс еда ошибка привязки карты
  • Php mysql ошибка запроса
  • Php вывести ошибку 500
  • Php mail ошибки отправки
  • Php вывести ошибки mysql

  • 0 0 голоса
    Рейтинг статьи
    Подписаться
    Уведомить о
    guest

    0 комментариев
    Старые
    Новые Популярные
    Межтекстовые Отзывы
    Посмотреть все комментарии