require_once 함수

require_once 함수는 지정된 파일을 현재 스크립트에 포함시킵니다. 만약 파일이 이전에 이미 포함되었다면, 함수는 해당 파일을 다시 포함시키지 않습니다. 이는 클래스나 함수가 정의된 파일을 포함할 때 특히 유용하며, 중복 포함으로 인한 오류를 방지할 수 있습니다.

구문

require_once 'path/to/file.php';

예시

config.php 파일을 포함해 봅시다:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

코드 실행 결과 (config.php에 $config 배열이 정의되어 있다면):

'My Site'

예시

같은 파일을 반복적으로 포함하려고 시도하기:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // 이 호출은 무시됨
	echo sum(2, 3);
?>

코드 실행 결과:

5

require와의 차이점

require와 달리, require_once 함수는 파일이 이미 포함되었는지 확인하고 중복 포함을 수행하지 않습니다. 이는 동일한 파일이 여러 번 포함되는 것을 막아 오류를 방지합니다.

함께 보기

파일을 포함하지만 중복 포함을 확인하지 않는 include 함수,
require_once와 유사하게 동작하지만 파일이 없을 때 치명적 오류를 발생시키지 않는 include_once 함수,