Função require_once

A função require_once inclui o arquivo especificado no script atual. Se o arquivo já foi incluído anteriormente, a função não o incluirá novamente. Isso é especialmente útil para incluir arquivos com classes ou funções, onde a inclusão repetida pode causar erros.

Sintaxe

require_once 'caminho/para/arquivo.php';

Exemplo

Vamos incluir o arquivo config.php:

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

Resultado da execução do código (se o array $config estiver definido em config.php):

'Meu Site'

Exemplo

Tentativa de incluir novamente o mesmo arquivo:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Esta chamada será ignorada
	echo sum(2, 3);
?>

Resultado da execução do código:

5

Diferença para require

Diferente de require, a função require_once verifica se o arquivo já foi incluído e não executa a inclusão repetida. Isso evita erros ao incluir o mesmo arquivo várias vezes.

Veja também

a função include,
que também inclui arquivos, mas não verifica sua inclusão repetida
a função include_once,
que funciona de forma semelhante ao require_once, mas não causa um erro fatal se o arquivo não for encontrado