PHP include 에러 해결 - 파일 경로 문제와 failed opening 대응법

📌 PHP include 에러 해결 - 파일 경로 문제와 failed opening 대응법

아래와 같은 에러 메시지를 PHP에서 자주 마주하나요?

Warning: include(config.php): failed to open stream: No such file or directory in /var/www/html/index.php on line 3
Warning: include(): Failed opening 'config.php' for inclusion

이 에러는 include 또는 require로 불러오는 파일이 존재하지 않거나 경로가 잘못되었을 때 발생합니다.

---

🧨 주요 원인

• 상대 경로 오타
• 파일 위치가 변경됨
• 루트 경로 기준이 다른 환경 (CLI vs 웹 서버)

---

🛠 해결 방법

1. 절대 경로로 명확히 지정

<?php
include __DIR__ . '/config.php';
?>

2. 파일 존재 여부 체크

<?php
$file = __DIR__ . '/config.php';
if (file_exists($file)) {
  include $file;
} else {
  echo "설정 파일이 존재하지 않습니다.";
}
?>

3. include_once 또는 require_once 사용

<?php
require_once __DIR__ . '/config.php';
?>

---

✅ 실무 팁

• __DIR__, dirname(__FILE__)로 절대 경로 사용 습관화
• 경로 관련 디버깅은 echo getcwd();로 현재 작업 디렉토리 확인
• 중요 설정 파일은 require_once로 필수 포함 처리

---

📚 관련 글

• PHP Cannot redeclare function 에러 해결법
• PHP Undefined index 에러 해결
• PHP Undefined variable 경고 해결

🧩 PHP 에러 시리즈 전체 보기