array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.include-once.php', 1 => 'include_once', ), 'up' => array ( 0 => 'language.control-structures.php', 1 => 'Estruturas de Controle', ), 'prev' => array ( 0 => 'function.require-once.php', 1 => 'require_once', ), 'next' => array ( 0 => 'control-structures.goto.php', 1 => 'goto', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'language/control-structures/include-once.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.