include_once( )

A instrução include_once( ) inclui e avalia o arquivo especificado durante a execução de um script . Seu comportamento é similar a instrução include( ) , a não ser que o arquivo informado tenha sido incluído , não refazendo a operação novamente . Como o nome sugere , ele será incluído apenas uma vez .

include_once( ) pode ser utilizado nos casos em que o mesmo arquivo pode acabar sendo incluído mais de uma vez durante a execução de um script em particular , quando na verdade ele pode ser incluído apenas uma para evitar problemas com redefinições de funções , alterações nos valores de variáveis , etc .

Para maiores informações utilizando require_once( ) e include_once( ) , veja o código do PEAR incluído nas últimas distribuições do código fonte do PHP .

Nota: include_once() foi acrescentado a partir PHP 4.0.1pl2

Nota : Esteja avisado que o comportamento de include_once( ) e require_once( ) pode não ser o que você espera em um sistema operacional insensitivo ao caso (como o Windows ) .

Exemplo 12-9 . include_once( ) é sensitivo ao caso

 
include_once(

 
"a.php")

 
;

 
/

 
/

 
isto

 
irá

 
incluir

 
a.php

 
include_once("A.php")

 
;

 
/

 
/

 
isto

 
irá

 
incluir

 
a.php

 
de

 
novo

 
no

 
Windows

 
!





Atenção

A versões Windows do PHP anteriores ao PHP 4.3 não suportam acesso a arquivos remotos através desta função , mesmo se allow_url_fopen estiver ativado .

Veja também : include( ) , require( ) , require_once( ) , get_required_files( ) , get_included_files( ) , readfile( ) e virtual( ) .