require( )

A instrução require( ) inclui a avalia um arquivo específico .

Informações detalhadas de como essa inclusão funciona está descrita na documentação do include( ) .

require( ) e include( ) são idênticos em todas as formas exceto pela manipulação de erros . include( ) produz um Warning enquanto require( ) produzirá um Fatal Error . Em outras palavras , não hesite em utilizar require( ) se na falta de um arquivo quiser parar o processamento da página . include( ) não se comporta da mesma maneira , e o script poderá continuar nessa situação . Em todo caso , vale a pena confirmar a configuração da diretiva include_path .

Exemplo 12-2 . Exemplos de require( ) s simples






Vaja a documentação de include( ) para mais exemplos .

Nota : Até o PHP 4.0.2 , havia o seguinte comportamento : require( ) mesmo que a linha onde ele está nunca seja executada . É por isso que instruções condicionais não afetam require( ) . Entretanto , se a linha onde ocorre o require( ) não for executada , nada do código incluído do arquivo também será . Similarmente , estruturas de loop não afetam o funcionamento do require( ) . Mas o código incluído pela função será submetida ao loop . A instrução require( ) apenas ocorre uma vez .

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_once( ) , include_once( ) , eval( ) , file( ) , readfile( ) , virtual( ) e include_path .