Помилки та їх обробка

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 об'єкта та встановлення режиму обробки помилок

Loading...
▶

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

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 та встановлення режиму обробки помилок у конструкторі

Loading...
▶

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

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