Incluir Arquivos do PHP

Este artigo irá examinar os métodos include e require do PHP, bem como sua sintaxe, comportamento e explorá-los através de alguns exemplos .

Inclui e requer, o que permite que você ou qualquer desenvolvedor reutilize facilmente o código.

No desenvolvimento da Web, é comum usar essas funções para incluir cabeçalhos e rodapés como parte de várias páginas, bem como para reutilizar o código em várias seções de um projeto.

Embora ambos incluam e exijam objetivos semelhantes, eles funcionam de maneira diferente e têm usos diferentes.

Desenvolvedores PHP de todos os níveis acharão este artigo valioso para aprender como usar PHP include e require de forma eficiente.



Instruções de inclusão e exigência do PHP

Com a ajuda das instruções include ou require do PHP, você pode inserir o conteúdo de um arquivo PHP em outro arquivo PHP (antes de ser executado pelo servidor) e, em seguida, executar o resultado.

No que diz respeito às instruções include e require , elas são idênticas, exceto no caso de falha:

Métodos Visão geral
exigir Se require for executado, um erro fatal (E_COMPILE_ERROR) será lançado e o script será interrompido
incluir Se você incluir uma linha, o script produzirá apenas um aviso (E_WARNING) e continuará em execução

Se você deseja que a execução continue e a saída seja mostrada ao usuário, mesmo que não haja um arquivo de inclusão disponível, você deve usar a instrução include .

Use a instrução require sempre que precisar incluir um arquivo de chave como parte de uma estrutura , CMS ou um programa PHP complexo. Ele protegerá a integridade e a segurança do seu aplicativo se um dos arquivos principais estiver faltando acidentalmente.

Você pode criar um cabeçalho , um rodapé e um arquivo de menu para cada página da Web que pretende criar.

Você só precisará atualizar o arquivo de cabeçalho se o cabeçalho precisar ser atualizado de tempos em tempos.

Sintaxe

include 'filename';

ou

require 'filename';

PHP Incluir Exemplos

Digamos que temos um arquivo de cabeçalho padrão chamado “headers.php” semelhante ao mostrado abaixo:

<?php
echo "Header file ";
?>

Um arquivo de cabeçalho pode ser incluído em uma página usando a instrução include da seguinte forma:

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
13
<html>
<body>
<?php include 'headers.php';?>
<h1>This is my home page!</h1>
<p>This is the first paragraph of the home page</p>
</body>
</html>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

O exemplo acima ilustra os fundamentos da instrução include do PHP.

Agora vamos usar o componente HTML para incluir nos arquivos PHP.

Vamos salvar tags de cabeçalho e rodapé HTML em arquivos diferentes e chamá-los na página inicial:

'header.php' inclui:

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Title name</title>
</head>
<body>

footer.php' inclui:

</body>
</html>

Agora, incluindo esses arquivos em home.php, fica assim:

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
<?php include 'header.php';?>
<h1>This is my Home Page!</h1>
<p>This is the first paragraph of the home page</p>
<?php include 'footer.php';?>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Vamos supor que temos um arquivo de menu padrão chamado “ menu.php ”:

<?php
echo '<a href="home.php">Home</a> –
<a href="aboutus.php">About Us</a> –
<a href="services.php">Services</a> –
<a href="contactus.php">Contact Us</a>';
?>
Este arquivo de menu deve ser utilizado por todas as páginas do site para facilitar a navegação.

O seguinte é um exemplo de como isso pode ser alcançado (estamos usando um elemento, pois facilita o estilo do menu com Tailwind CSS posteriormente):

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
13
<html>
<body>
<div class="navigation"><?php include 'menu.php';?></div>
<h1>This is my home page!</h1>
<p>This is the first paragraph of the home page.</p>
</body>
</html>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

No exemplo abaixo, assumiremos que temos um arquivo chamado user.php , que contém as seguintes variáveis:

<?php
$first_name='Bill';
$last_name='Gates';
?>

Ao incluir o arquivo user.php , poderemos utilizar as variáveis ​​que foram armazenadas no arquivo user.php:

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
13
<html>
<body>
<h1>This is my home page!</h1>
<?php include 'user.php';
echo "$first_name $last_name is the Co-Founder of Microsoft";?>
</body>
</html>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Requer PHP

A instrução PHP require também pode ser usada para incluir um arquivo de um local específico.
No entanto, há uma diferença particularmente importante entre incluir e exigir.
O script continuará a executar se um arquivo não puder ser encontrado pelo PHP quando o script for feito com a instrução include:

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<html>
<body>
<h1>This is my Home Page!</h1>
<?php include 'file_not_exist.php';
echo "$first_name $last_name is the Co-Founder of Microsoft.";?>
</body>
</html>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Por exemplo, se usarmos a instrução require no mesmo exemplo, não poderemos executar a instrução echo .

Isso ocorre porque a execução do script será encerrada depois que a instrução require retornar um erro fatal:

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<html>
<body>
<h1>This is my Home Page!</h1>
<?php require 'file_not_exist.php';
echo "$first_name $last_name is the Co-Founder of Microsoft.";?>
</body>
</html>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Incluir PHP vs Obrigatório

O método require é usado quando um aplicativo precisa de um arquivo para funcionar.

O método include do PHP deve ser usado quando um arquivo não é necessário e o aplicativo deve continuar em execução sem que o arquivo seja encontrado quando não estiver disponível.

Vamos mesclar todo o exemplo acima em um único exemplo com rodapés de cabeçalho e arquivo de usuário usando a instrução include:

Example: 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<?php include 'header.php';?>
<div class="navigation"><?php include 'menu.php';?></div>
<h1>This is my Home Page!</h1>
<p>This is the first paragraph of the home page</p>
<?php include 'user.php';
echo "$first_name $last_name is the Co-Founder of Microsoft.";?>
<?php include 'footer.php';?>
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Exemplo de Explicação

O exemplo acima demonstra como usar a função include para incluir arquivos externos em uma página da web.
Veja como o código funciona:
  • Primeiro usamos o método PHP include para incluir um arquivo externo chamado header.php . Este arquivo provavelmente contém código HTML que deve ser exibido na parte superior da página (por exemplo, um logotipo ou uma barra de navegação) .
  • Em seguida, criamos um elemento <div> com a classe de navegação e usamos o include novamente para incluir um arquivo externo chamado menu.php . Este arquivo provavelmente contém o código para um menu de navegação que deve ser exibido dentro do <div> .
  • A terceira linha do exemplo acima cria um elemento <h1> e algum texto que diz “ This is my Home Page! ” Este é o conteúdo principal da página.
  • A quarta linha do exemplo cria um elemento <p> com algum texto adicional para a página.
  • A quinta linha do exemplo usa a função include novamente para incluir um arquivo externo chamado user.ph “. Este arquivo provavelmente contém código PHP que define as variáveis ​​$first_name e $last_name para os nomes do autor ou proprietário da página.
  • Em seguida, usamos as variáveis ​​$first_name e $last_name para gerar uma frase que diz quem é o co-fundador da Microsoft .
  • Finalmente, o método PHP include é usado para incluir um arquivo externo chamado footer.php . Este arquivo provavelmente contém código HTML que deve ser exibido na parte inferior da página (por exemplo, informações de direitos autorais ou um link para a política de privacidade do site).

O exemplo acima demonstra como usar o método include em PHP para modularizar uma página da Web em componentes menores e reutilizáveis. Ao separar diferentes partes da página em arquivos separados, você pode facilitar o gerenciamento e a manutenção do código.

Além disso, você pode evitar a duplicação do mesmo código em várias páginas.

Nós valorizamos o seu feedback.
+1
0
+1
0
+1
0
+1
0
+1
0
+1
0
+1
0

Assine a nossa newsletter
Digite seu e-mail para receber um resumo semanal de nossos melhores posts. Saber mais!
ícone