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 já 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 só 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.1

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).

Example#1 include_once() não diferencia maiúsculas e minuúsculas no Windows

<?php
include_once "a.php"; // isto irá incluir a.php
include_once "A.php"; // isto irá incluir a.php novamente no Windows! (Apenas PHP 4)
?>

Este funcionamento mudou no PHP 5 - o caminho é normalizado primeiro, assim C:\PROGRA~1\A.php é realizado como o mesmo que C:\Program Files\a.php e o arquivo é incluído apenas uma vez.

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