PDO::errorCode

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDO::errorCode — 데이터베이스 핸들에 대한 마지막 작업과 관련된 SQLSTATE를 가져옵니다.


설명

public PDO::errorCode(): ?string


매개변수

이 함수에는 매개변수가 없습니다.


반환 값

ANSI SQL-92 표준에 정의된 5자의 영숫자 식별자인 SQLSTATE를 반환합니다. 간단히 말해서, SQLSTATE는 2개의 문자 클래스 값과 3개의 문자 서브클래스 값으로 구성됩니다. 01의 클래스 값은 경고를 나타내며 SQL_SUCCESS_WITH_INFO의 반환 코드와 함께 제공됩니다. 'IM' 클래스를 제외한 '01' 이외의 클래스 값은 오류를 나타냅니다. 'IM' 클래스는 PDO(또는 ODBC 드라이버를 사용하는 경우 ODBC) 자체의 구현에서 파생되는 경고 및 오류와 관련이 있습니다. 모든 클래스의 하위 클래스 값 '000'은 해당 SQLSTATE에 대한 하위 클래스가 없음을 나타냅니다.

PDO::errorCode()는 데이터베이스 핸들에서 직접 수행되는 작업에 대한 오류 코드만 검색합니다. PDO::prepare() 또는 PDO::query()를 통해 PDOStatement 객체를 생성하고 명령문 핸들에서 오류를 호출하면 PDO::errorCode()는 해당 오류를 반영하지 않습니다. 특정 명령문 핸들에서 수행된 작업에 대한 오류 코드를 반환하려면 PDOStatement::errorCode()를 호출해야 합니다.

데이터베이스 핸들에서 실행된 작업이 없으면 null을 반환합니다.

Examples

예제 #1 SQLSTATE 코드 검색

                  
<?php
/* Provoke an error -- the BONES table does not exist */
$dbh->exec("INSERT INTO bones(skull) VALUES ('lucy')");

echo "\nPDO::errorCode(): ", $dbh->errorCode();
?>
                  
                

위의 예는 다음을 출력합니다.

PDO::errorCode(): 42S02
                

기타

  • PDO::errorInfo() - 데이터베이스 핸들에 대한 마지막 작업과 관련된 확장 오류 정보를 가져옵니다.
  • PDOStatement::errorCode() - 명령문 핸들의 마지막 작업과 연관된 SQLSTATE를 가져옵니다.
  • PDOStatement::errorInfo() - 명령문 핸들의 마지막 작업과 관련된 확장 오류 정보를 가져옵니다.