PHP의 user_error() 함수는 trigger_error() 함수의 별칭(alias)으로, 개발자가 직접 사용자 수준의 오류 조건을 발생시킬 때 사용합니다. 이 함수는 PHP에 내장된 기본 에러 핸들러와 함께 사용할 수 있으며, set_error_handler()로 등록한 사용자 정의 에러 핸들러 함수와 연동하여 활용할 수도 있습니다.
문법(Syntax)
user_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)
user_error() 함수는 잘못된 error_type이 지정된 경우 FALSE를 반환하고, 그렇지 않으면 TRUE를 반환합니다.
예제(Example)
다음은 user_error() 함수를 사용하는 간단한 예제입니다 −
<?php
if ($demo<10) {
user_error("Number cannot be less than 2");
}
?>
실행 결과(Output)
위 코드를 실행하면 다음과 같은 결과가 출력됩니다 −
PHP Notice: Undefined variable: demo in /home/cg/root/4127336/main.php on line 2
PHP Notice: Number cannot be less than 2 in /home/cg/root/4127336/main.php on line 3
정리
user_error() 함수는 디버깅이나 조건 검증 시 유용하게 활용됩니다. 특히 함수 인자의 유효성 검사나 비정상적인 상태 감지 시 적절한 오류 유형(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE)을 선택해 사용하면, 코드의 안정성과 유지보수성을 크게 향상시킬 수 있습니다. 참고로 이 함수는 trigger_error()와 완전히 동일하게 동작하므로, 최신 PHP 코딩 표준에서는 trigger_error() 사용을 권장하기도 합니다.