【PHP8.x】PDOStatement::errorCode()メソッドの使い方

errorCodeメソッドは、PHPのデータベース操作拡張であるPDOにおいて、PDOStatementオブジェクトが実行したSQL文にエラーが発生した際、そのエラーの種類を示すコードを取得するために使用されるメソッドです。具体的には、このメソッドはSQLSTATEと呼ばれる5文字の英数字からなるエラーコードを返します。SQLSTATEは、データベース操作に関するエラーを標準的に識別するためにSQL標準で定義されており、どのような問題が発生したのかを具体的に特定するのに役立ちます。

例えば、データベースに存在しないテーブルへのアクセスや、データ型が一致しない値の挿入など、様々なデータベース関連のエラーにそれぞれ固有のSQLSTATEコードが割り当てられています。システム開発において、データベースとの連携は不可欠であり、エラーが発生した際にはその原因を迅速に特定し、適切に対処することが重要です。このerrorCodeメソッドから得られる情報は、エラーの原因をデバッグする際や、ユーザーに分かりやすいエラーメッセージを表示するためのエラーハンドリングロジックを実装する上で不可欠となります。

もし、PDOStatementオブジェクトによるデータベース操作が正常に完了し、エラーが一切発生していない場合は、このメソッドは「成功」または「エラーなし」を意味する'00000'という5文字の文字列を返します。したがって、このメソッドの戻り値をチェックすることで、SQL文の実行が成功したかどうか、またはどのような種類のエラーが発生したのかを正確に判断することができます。

Copy
1<?php
2$pdo = new PDO('sqlite::memory:');
3$stmt = $pdo->prepare('SELECT 1');
4$stmt->execute();
5$errorCode = $stmt->errorCode();
6?>

引数なし

引数はありません

string|null

PDOStatement::errorCode メソッドは、直前の PDOStatement オブジェクトでの操作で発生したエラーコードを文字列で返します。エラーが発生しなかった場合は null を返します。