(PHP 4, PHP 5, PHP 7)
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 essa função funciona.
Nota:
No PHP 4, as funcionalidades _once diferem em sistemas operacionais case-insensitive (como o Windows), por exemplo
Exemplo #1 Uso do include_once em um SO case insensitive no PHP 4
<?php
include_once "a.php"; // this will include a.php
include_once "A.php"; // this will include a.php again! (PHP 4 only)
?>Este comportamento foi modificado no PHP 5, por exemplo, no Windows o caminho é normalizados primeiro, então isto C:\PROGRA~1\A.php e o mesmo que C:\Program Files\a.php e o arquivo é incluído somente uma vez.