PHP headers already sent 오류의 최초 출력 찾기

header 또는 session_start 호출에서 이미 헤더를 보냈다는 경고가 난다는 상황에서 PHP 특유의 원인을 확인하고 안전하게 해결하는 순서입니다.

PHPCross-platform

짧은 요약

header 또는 session_start 호출에서 이미 헤더를 보냈다는 경고가 난다면 최초 출력 지점을 제거하고 응답 헤더를 본문 렌더링 전에 결정한다. 무작정 전체 설정을 초기화하기보다 해당 기술이 실제로 선택한 실행 경로와 로그를 먼저 확인합니다.

증상과 환경

  • 중심 분류: 개발 언어
  • 대상: PHP

header 또는 session_start 호출에서 이미 헤더를 보냈다는 경고가 난다. 오류 원문, 버전, 실행 계정과 직전 변경을 함께 기록하면 비슷한 범용 문제와 구분할 수 있습니다.

원인

BOM, 공백, 경고 출력 또는 템플릿 내용이 HTTP header보다 먼저 전송됐다. 이 동작은 PHP의 실행 모델이나 기본 정책에 따른 것이므로 다른 환경의 해결법을 그대로 적용하면 부작용이 생길 수 있습니다.

재현 예시

영향이 제한된 테스트 디렉터리에서 아래 진단을 실행해 정상 입력과 실패 입력의 첫 차이를 확인합니다. 운영 비밀값은 마스킹하고, 변경 전에 현재 설정과 결과를 복사해 둡니다.

단계별 해결법

1. 오류 전문과 PHP 버전, 실행 계정, 대상 경로를 확인합니다.

2. 읽기 전용 진단 명령으로 “BOM, 공백, 경고 출력 또는 템플릿 내용이 HTTP header보다 먼저 전송됐다” 가설을 검증합니다.

3. 최초 출력 지점을 제거하고 응답 헤더를 본문 렌더링 전에 결정한다.

4. 같은 입력으로 수정 전후를 비교하고 깨끗한 세션에서도 다시 확인합니다.

코드·명령 예문

php -l index.php
php -d display_errors=1 index.php
# 오류의 output started at 파일:줄 확인

꺾쇠로 표시한 값은 실제 대상에 맞게 바꿉니다. 삭제·보안 정책 변경은 예문의 진단 결과를 확인한 뒤 진행합니다.

확인법

오류를 일으킨 최소 입력을 다시 실행해 종료 코드와 로그를 확인합니다. 관련 테스트를 두 번 연속 통과하고 새 세션 또는 동일한 자동화 환경에서도 결과가 같아야 해결된 것으로 봅니다.

주의사항

보안 검증을 끄거나 관리자 권한으로 상시 실행하는 우회는 사용하지 않습니다. 공유 설정을 바꿀 때는 diff와 복원 방법을 확보하고, 실제 버전의 공식 문서에서 옵션 지원 여부를 확인합니다.

관련 이슈

  • PHP 실행 모델과 기본 정책
  • 개발 환경과 자동화 환경의 차이
  • 설정 우선순위와 캐시된 이전 상태
  • 버전 업그레이드 시 호환성 확인