Função include_once

A função include_once inclui o arquivo especificado no script PHP atual, mas somente se ele não tiver sido incluído anteriormente. Isso é especialmente útil ao trabalhar com arquivos que contêm declarações de funções ou classes, para evitar erros de redeclaração. O parâmetro da função recebe o caminho para o arquivo a ser incluído.

Sintaxe

include_once 'path/to/file.php';

Exemplo

Vamos incluir o arquivo config.php apenas uma vez:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Esta chamada será ignorada
?>

Exemplo

Tentativa de incluir um arquivo que não existe:

<?php
	include_once 'nonexistent.php'; // Gerará um aviso, mas não interromperá a execução do script
	echo 'O script continua...';
?>

Resultado da execução do código:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
O script continua...

Exemplo

Usando uma variável para especificar o caminho:

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

Veja também

a função include,
que inclui um arquivo sem verificação de inclusão repetida
a função require,
que inclui um arquivo com parada do script em caso de erro
a função require_once,
que funciona como include_once, mas interrompe o script em caso de erro