본문 바로가기
프로그래밍/php

PHP 에러 표시하는 방법 완벽 가이드 🌟

by 마루의 일상 2025. 3. 15.
728x90
반응형

PHP에서 에러 표시를 활성화하고 디버깅하는 방법을 제대로 알고 있다면 개발할 때 훨씬 더 수월하게 문제를 해결할 수 있습니다. 이번 포스팅에서는 PHP 에러 표시를 활성화하고 에러 메시지를 효과적으로 관리하는 방법을 단계별로 알려드리겠습니다.


✅ 1. PHP 에러 표시란?

PHP 에러 표시는 PHP 코드에서 발생하는 오류나 경고를 화면에 출력하여 문제의 원인을 쉽게 파악할 수 있게 도와주는 기능입니다. 개발 단계에서 특히 유용하며, 올바르게 설정하는 것이 중요합니다.


📌 2. php.ini 설정 변경하기

PHP는 기본 설정 파일인 php.ini에서 에러 표시 여부를 관리합니다. 이를 수정하여 에러 메시지를 활성화할 수 있습니다.

설정 파일 경로 확인하기

php -i | grep "Loaded Configuration File"

위 명령어를 입력하면 현재 사용 중인 php.ini 파일의 경로를 확인할 수 있습니다.

설정 변경하기

php.ini 파일을 열어 아래 항목들을 수정합니다.

; 모든 오류를 표시하도록 설정
error_reporting = E_ALL

display_errors = On
display_startup_errors = On

위 설정을 저장한 후 웹 서버를 재시작합니다.


📌 3. 코드에서 에러 표시 설정하기

코드에서 직접 설정을 변경할 수도 있습니다. 이 방법은 일시적으로 에러 표시를 활성화하거나 개발 환경에서만 사용하기 좋습니다.

<?php
    // 모든 오류를 보고하도록 설정
    error_reporting(E_ALL);
    ini_set('display_errors', '1');
    ini_set('display_startup_errors', '1');
?>

이 코드를 프로젝트의 최상단 파일에 추가하면, 모든 에러가 브라우저 화면에 표시됩니다.


📌 4. 에러 로그 파일 확인하기

개발 환경이 아닌 서버 환경에서는 에러 메시지를 브라우저에 표시하지 않고 로그 파일로 저장하는 것이 좋습니다.

log_errors = On
error_log = /path/to/your/error.log

에러 로그 파일의 경로를 지정하고, 에러 로그 기능을 활성화하면 모든 에러가 해당 파일에 기록됩니다.


📌 5. 에러 발생 테스트

설정이 제대로 되었는지 확인하려면 의도적으로 오류를 발생시켜 볼 수 있습니다.

<?php
echo $undefined_variable;

위 코드를 실행했을 때 에러 메시지가 출력되면 설정이 성공적으로 적용된 것입니다.


💡 6. 개발 환경과 배포 환경 설정 구분하기

개발 환경에서는 에러 메시지를 화면에 표시하는 것이 좋지만, 배포 환경에서는 보안 문제를 방지하기 위해 에러를 로그 파일로 저장하는 것이 좋습니다.

if ($_SERVER['SERVER_NAME'] === 'localhost') {
    error_reporting(E_ALL);
    ini_set('display_errors', '1');
} else {
    error_reporting(E_ALL);
    ini_set('display_errors', '0');
    ini_set('log_errors', '1');
    ini_set('error_log', '/path/to/your/error.log');
}

📌 7. 결론

에러 표시를 올바르게 설정하는 것은 디버깅과 문제 해결의 핵심입니다. PHP의 에러 표시 기능을 적절히 활용하면 더 효율적으로 개발을 진행할 수 있습니다. 이상으로 PHP 에러 표시 방법에 대한 가이드를 마칩니다. 😊


TIP: 항상 배포 환경에서는 에러 메시지를 숨기고 로그 파일로 저장하도록 설정하세요!


 

728x90
반응형