www.samueldiasneto.com: Tutorial PHP

<<< Voltar Avançar >>>

11. require() e include()

Use a função require() para reaproveitar código e tornar os sites consistentes. Exemplo:

<html>
<head>
<title>Jeg's</title>
</head>
<body>
<?php
  require('cabecalho.inc');
?>

// conteúdo do site

<?php
  require('rodape.inc');
?>
</body>

No código acima o cabeçalho e o rodapé são carregados usando a função require(). Os arquivos "cabecalho.inc" e "rodape.inc" tem a codificação desejada para o cabeçalho e para o rodapé. Usando esta técnica todas as páginas do site terão o mesmo cabeçalho e rodapé, conferindo mais uniformidade e reduzindo a probabilidade de erros. Sem contar que, caso ocorra uma mudança, você só precisará alterar os arquivos "cabecalho.inc" e "rodape.inc", e não todas as páginas do site.

Por convenção os arquivos utilizados neste tipo de técnica devem ter a extensão .inc.

Por segurança, este arquivos devem estar fora do diretório onde os documentos web estão, pois caso um usuário tente carregá-los no navegador ele verá os arquivos em texto simples, incluindo qualquer senha que porventura exista.

Basicamente, a função include() é semelhante a require(). A diferença é que include() pode retornar um valor. Porém, se sua intenção é retornar algo, é interessante avaliar se não será melhor definir uma nova função em vez de usar include().

<<< Voltar Avançar >>>