함수 include_once

함수 include_once는 이전에 포함되지 않은 경우에만 지정된 파일을 현재 PHP 스크립트에 포함합니다. 이는 함수나 클래스 선언이 포함된 파일을 다룰 때 중복 선언 오류를 방지하는 데 특히 유용합니다. 함수 매개변수로 포함할 파일의 경로가 전달됩니다.

문법

phpinclude_once 'path/to/file.php';

예시

파일 config.php를 한 번만 포함하기:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // 이 호출은 무시됨
?>

예시

존재하지 않는 파일 포함 시도:

php<?php
  include_once 'nonexistent.php'; // 경고를 발생시키지만 스크립트 실행은 중단하지 않음
  echo 'Script continues...';
?>

코드 실행 결과:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

예시

경로 지정을 위한 변수 사용:

php<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

함께 보기

  • 함수 include,
    중복 포함 확인 없이 파일을 포함합니다
  • 함수 require,
    오류 발생 시 스크립트를 중단하며 파일을 포함합니다
  • 함수 require_once,
    include_once와 유사하게 동작하지만 오류 발생 시 스크립트를 중단합니다