(PHP 4, PHP 5, PHP 7, PHP 8)
A declaração include_once
inclui e avalia o arquivo informado durante a execução do script. Este é um comportamento similar a declaração include, com a única diferença que, se o código do arquivo já foi incluído, não o fará novamente, e o include_once retornará true
. Como o nome sugere, o arquivo será incluído somente uma vez.
O include_once
pode ser utilizado em casos em que o mesmo arquivo pode ser incluído e valiado mais de uma vez durante uma execução de um script em particular, neste caso, ajudará a evitar problemas como redefinição de funções, reatribuição de valores de variáveis, e etc.
Veja a documentação da declaração include para informações sobre como esta função funciona.