함수 include_once

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

문법

include_once 'path/to/file.php';

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

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

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

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

코드 실행 결과:

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

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

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