Resumo de Include() e Require() em PHP -

Include() e Require() em PHP

Você pode inserir o conteúdo de um arquivo PHP em outro arquivo PHP antes do servidor executá-lo, com as funções include() ou require(). As duas funções são idênticas em todas as maneiras, exceto no tratamento de erros:

- include() gera uma mensagem de alerta, mas o script continua executando.
- require() gera um fatal error e interrompe a execução do script.

Estas duas funções são utilizadas para criar funções, cabeçalhos, rodapés ou qualquer outro elemento que será reutilizado em múltiplas páginas. Estas funções são chamadas de Server Side Include (SSI).

Server side includes poupam bastante trabalho. Isto significa que você pode criar um elemento padrão, como um menu ou um cabeçalho, e utiliza-lo em todas as páginas no seu site. Quando os cabeçalhos necessitarem de um upgrade, você só precisa mudar o arquivo do cabeçalho, ou quando você inserir uma nova página, você só precisa alterar o arquivo de menu ao invés de vivitar todas as páginas para atualizar o menu com o novo link.
_______________________________________________________________________________
A função include():

A função include() pega todo o conteúdo de um arquivo específico e inclui no arquivo atual.

Se um erro ocorre, a função include() gera uma mensagem de alerta, mas o script continua executando.

Exemplo 1:

Suponha que você tenha um cabeçalho padrão em um arquivo, chamado "header.php". Para inserir o cabeçalho do arquivo na página, utilize a função include():

<html>
<body>

<?php include("header.php"); ?>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>

</body>
</html>

Exemplo 2:

Suponha que você tem um arquivo de menu padrão, chamado "menu.php", que deve ser usado em todas as páginas:

<a href="/default.php">Home</a>
<a href="/tutorials.php">Tutorials</a>
<a href="/references.php">References</a>
<a href="/examples.php">Examples</a>
<a href="/about.php">About Us</a>
<a href="/contact.php">Contact Us</a>

Todas as páginas devem inserir este arquivo de menu:

<html>
<body>

<div class="leftmenu">
<?php include("menu.php"); ?>
</div>

<h1>Welcome to my home page.</h1>
<p>Some text.</p>

</body>
</html>

Se você olhar o código fonte da página acima (no browser), ele será assim:

<html>
<body>

<div class="leftmenu">
<a href="/default.php">Home</a>
<a href="/tutorials.php">Tutorials</a>
<a href="/references.php">References</a>
<a href="/examples.php">Examples</a>
<a href="/about.php">About Us</a>
<a href="/contact.php">Contact Us</a>
</div>

<h1>Welcome to my home page!</h1>
<p>Some text.</p>

</body>
</html>
_______________________________________________________________________________
Função require() em PHP:

A função require() é idêntica à função include(), exceto na forma de tratamento de erros.

Se um erro ocorre, a função require() gera um erro fatal e interrompe o script.

Exemplo de erro na função include():

<html>
<body>

<?php
include("wrongFile.php");
echo "Hello World!";
?>

</body>
</html>

Mensagem de erro:

Warning: include(wrongFile.php) [function.include]:
failed to open stream:
No such file or directory in C:\home\website\test.php on line 5

Warning: include() [function.include]:
Failed opening 'wrongFile.php' for inclusion
(include_path='.;C:\php5\pear')
in C:\home\website\test.php on line 5

Hello World!

Note que a declaração 'echo' foi executada! Isto porque a mensagem de alerta não interrompeu a execução do script.

Exemplo de erro na função require():

Agora, vamos rodar o mesmo exemplo na função require():

<html>
<body>

<?php
require("wrongFile.php");
echo "Hello World!";
?>

</body>
</html>

Mensagem de erro:

Warning: require(wrongFile.php) [function.require]:
failed to open stream:
No such file or directory in C:\home\website\test.php on line 5

Fatal error: require() [function.require]:
Failed opening required 'wrongFile.php'
(include_path='.;C:\php5\pear')
in C:\home\website\test.php on line 5

A declaração 'echo' não foi executada porque o script foi interrompido na mensagem de alerta.
_______________________________________________________________________________

Resumos Relacionados