PHP의 trigger_error() 함수는 개발자가 직접 사용자 정의(user-defined) 오류 메시지를 생성할 수 있도록 해주는 함수입니다. 코드 실행 중 특정 조건에서 경고나 알림을 의도적으로 발생시켜야 할 때 유용하게 활용됩니다.
문법(Syntax)
trigger_error(error_msg, error_type)
매개변수(Parameters)
error_msg − 표시할 오류 메시지를 지정합니다. 메시지 길이는 최대 1024자로 제한됩니다.
error_type − 발생시킬 오류의 유형을 지정합니다. 이 매개변수는 선택 사항입니다.
사용 가능한 오류 유형
E_USER_ERROR − 사용자가 생성한 치명적인(fatal) 런타임 오류입니다. 복구가 불가능하며, 스크립트 실행이 즉시 중단됩니다.
E_USER_WARNING − 사용자가 생성한 치명적이지 않은(non-fatal) 런타임 경고입니다. 스크립트 실행은 계속 진행됩니다.
E_USER_NOTICE − 기본값(Default). 사용자가 생성한 런타임 알림(notice)입니다. 스크립트에서 잠재적인 오류로 보이는 것을 발견했지만, 정상적인 실행 과정에서도 발생할 수 있는 상황을 나타냅니다.
반환값(Return Value)
trigger_error() 함수는 잘못된 error_type이 지정된 경우 FALSE를 반환하고, 그렇지 않으면 TRUE를 반환합니다.
예제(Example)
다음은 trigger_error() 함수의 사용 예입니다.
<?php
if ($demo<50) {
trigger_error("Number cannot be less than 50");
}
?>실행 결과(Output)
위 코드를 실행하면 다음과 같은 사용자 정의 오류 메시지가 출력됩니다.
PHP Notice: Undefined variable: demo in /home/cg/root/4127336/main.php on line 2 PHP Notice: Number cannot be less than 50 in /home/cg/root/4127336/main.php on line 3
출력 결과를 살펴보면, 두 번째 줄에 우리가 trigger_error()로 지정한 "Number cannot be less than 50"이라는 커스텀 알림 메시지가 표시되는 것을 확인할 수 있습니다. 또한 첫 번째 줄의 "Undefined variable: demo"는 $demo 변수가 정의되지 않은 상태에서 사용되었기 때문에 PHP가 자동으로 출력한 내장 알림입니다.