(PHP 4, PHP 5, PHP 7, PHP 8)
A expressão include_once
inclui e avalia
o arquivo informado durante a execução do script.
Este é um comportamento similar à expressão include,
com a única diferença que, se o código do arquivo já foi
incluído, não o fará novamente, e a include_once retornará true
. Como o nome sugere,
o arquivo será incluído somente uma vez.
A include_once
pode ser utilizada 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, etc.
Consulte a documentação da expressão include para informações sobre como ela funciona.