Função require

A função require inclui e executa o arquivo especificado no script atual. Diferente de include, na ausência do arquivo, causa um erro fatal e interrompe a execução do script. A função é frequentemente usada para incluir arquivos importantes com funções, classes ou configurações.

Sintaxe

phprequire 'caminho/para/arquivo.php';

Exemplo

Incluindo um arquivo de configurações:

php<?php
  require 'config.php';
  echo $db_host; // Variável do config.php
?>

Se o arquivo config.php existir, seu conteúdo será executado e as variáveis ficarão disponíveis.

Exemplo

Tentativa de incluir um arquivo inexistente:

php<?php
  require 'arquivo_inexistente.php';
  echo 'Esta linha não será executada';
?>

Se o arquivo arquivo_inexistente.php não existir, o script terminará com um erro.

Diferença entre require e include

A principal diferença é que require causa um erro fatal na ausência do arquivo, enquanto include emite apenas um aviso.

php<?php
  include 'arquivo_opcional.php'; // O script continuará a execução
  require 'arquivo_obrigatorio.php'; // O script será interrompido em caso de erro
?>

Veja também