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

require 'caminho/para/arquivo.php';

Exemplo

Incluindo um arquivo de configurações:

<?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
	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
	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

a função include,
que também inclui arquivos, mas não interrompe o script em caso de erro
a função require_once,
que garante a inclusão única do arquivo