Manual do PHP
Anterior | Capítulo 16. Estruturas de Controle | Próxima

# 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 16-2. Exemplos de require()s simples

`<?php require 'prepend.php'; require $somefile; require ('somefile.txt'); ?>`

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

> Nota: Até o PHP 4.0.2, havia o seguinte comportamento: require() sempre tentará ler o arquivo informado, mesmo que que a linha do require 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.

> Nota: Este é um construtor de linguagem e não uma função, por isso não é possível chamá-lo através de funções variáveis

Atenção
A versões Windows do PHP anteriores ao PHP 4.3.0 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.

Anterior | Principal | Próxima
return | Acima | include()