PHP의 error_log() 함수는 오류 메시지를 서버의 에러 로그, 특정 파일 또는 원격 대상으로 전송하는 데 사용됩니다. 별도의 화면 출력 없이 조용히 오류를 기록해야 할 때 매우 유용하며, 운영 환경에서 디버깅 정보를 남기는 표준적인 방법 중 하나입니다.
문법(Syntax)
error_log(message, message_type, destination, extra_headers)
매개변수(Parameters)
message − 로그에 기록할 오류 메시지입니다.
message_type − 오류를 어디로 전송할지 지정합니다. 사용 가능한 값은 다음과 같습니다.
0(기본값) − php.ini 파일의
error_log설정에 따라 서버의 로깅 시스템 또는 지정된 파일로 오류를 전송합니다.1 − destination 매개변수에 지정된 이메일 주소로 오류를 전송합니다. 이 유형만 extra_headers 매개변수를 함께 사용할 수 있습니다.
2 − PHP 디버깅 연결을 통해 오류를 전송합니다. 이 옵션은 PHP 3에서만 사용 가능합니다.
3 − destination 문자열로 지정한 파일에 오류 내용을 추가(기록)합니다.
destination − message_type 값에 따라 의미가 달라집니다. 예를 들어 message_type이 3이면 오류를 기록할 파일 경로를, 1이면 수신자 이메일 주소를 지정합니다.
extra_headers − message_type이 1로 설정된 경우에만 사용되는 추가 헤더입니다. 내부적으로
mail()함수와 동일한 메커니즘을 사용하므로 From, Cc 등의 메일 헤더를 지정할 수 있습니다.
반환값(Return)
error_log() 함수는 실행에 성공하면 TRUE를, 실패하면 FALSE를 반환합니다.
예제(Example)
다음은 error_log() 함수를 사용하여 파일에 오류를 기록하는 예제입니다.
<?php
error_log("That’s no good!", 3, "/var/tmp/my-errors.log");
?>
위 코드를 실행하면 "That’s no good!"이라는 텍스트가 /var/tmp/my-errors.log 파일에 저장됩니다. message_type을 3으로 지정했기 때문에 서버 설정과 무관하게 해당 파일에 직접 로그가 기록되며, 파일이 없는 경우 새로 생성됩니다.