Resumo : neste tutorial, você aprenderá como incluir código de um arquivo usando a include
construção PHP.
Introdução ao PHP inclui construção
A include
construção permite carregar o código de outro arquivo em um arquivo. Aqui está a sintaxe da include
construção:
include 'path_to_file';
Linguagem de código: PHP ( php )
Nesta sintaxe, você coloca o caminho para o arquivo após a include
palavra-chave. Por exemplo, para carregar o código de um functions.php
arquivo em um index.php
arquivo, você pode usar a seguinte include
instrução:
<?php
// index.php file
include 'functions.php';
Linguagem de código: HTML, XML ( xml )
Se o PHP não conseguir encontrar o 'functions.php'
arquivo no src
diretório, ele emitirá um aviso. Por exemplo:
Warning: include(functions.php): failed to open stream: No such file or directory in ... on line 4
Warning: include(): Failed opening 'functions.php' for inclusion (include_path='\xampp\php\PEAR') in ... on line 4
Linguagem de código: PHP ( php )
Ao carregar o functions.php
arquivo, o PHP primeiro procura o functions.php
arquivo no diretório especificado pela extensão include_path
. Neste exemplo, é '\xampp\php\PEAR'
. Se o PHP puder encontrar o functions.php
arquivo lá, ele carregará o código do arquivo.
Caso contrário, o PHP pesquisa o functions.php
arquivo no diretório do script de chamada e no diretório de trabalho atual. Se o PHP conseguir encontrar o functions.php
arquivo lá, ele carrega o código. Caso contrário, emite um aviso se o arquivo não existir.
Quando o PHP carrega o functions.php
arquivo, ele na verdade executa o código dentro do functions.php
arquivo. Por exemplo, se você colocar o seguinte código no functions.php
arquivo:
<?php
// functions.php
function get_copyright()
{
return 'Copyright © ' . date('Y') . ' by tutorials.acervolima.com. All Rights Reserved!';
}
echo get_copyright();
Linguagem de código: HTML, XML ( xml )
e incluir no functions.php
arquivo index.php
, você verá a seguinte saída ao executar o index.php
arquivo:
Copyright © 2021 by phptutorial.net. All Rights Reserved!
Linguagem de código: CSS ( css )
Isso demonstrou que a include
construção faz com que o PHP execute o código no functions.php
arquivo.
PHP inclui exemplo
Na prática, você usará frequentemente a include
construção para os elementos da página a partir de um design geral de site. Por exemplo, todas as páginas do seu site podem ter o mesmo cabeçalho e rodapé.
Para evitar a repetição desses elementos em várias páginas, você pode colocar o código do cabeçalho e rodapé em arquivos separados, como header.php
e, footer.php
e incluí-los nas páginas.
Normalmente, você coloca os arquivos de modelo como header.php
e footer.php
em um diretório separado. Por convenção, o nome do include
diretório é inc
:
.
├── index.php
├── functions.php
├── inc
│ ├── footer.php
│ └── header.php
└── public
├── css
│ └── style.css
└── js
└── app.js
Linguagem de código: CSS ( css )
O header.php
arquivo contém o código do cabeçalho da página. Possui um link para o style.css
arquivo localizado no public/css
diretório:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" href="public/css/style.css">
<title>PHP include Example</title>
</head>
<body>
Linguagem de código: HTML, XML ( xml )
O footer.php
arquivo contém o código relacionado ao rodapé da página:
<script src="js/app.js"></script>
</body>
</html>
Linguagem de código: HTML, XML ( xml )
No index.php
arquivo, você pode incluir o arquivo header.php
e footer.php
assim:
<?php include 'inc/header.php'; ?>
<h1>PHP include</h1>
<p>This shows how the PHP include construct works.</p>
<?php include 'inc/footer.php'; ?>
Linguagem de código: HTML, XML ( xml )
Se você executar o index.php
arquivo e visualizar o código-fonte da página, também verá o código dos arquivos header.php
e :footer.php
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" href="public/css/style.css" />
<title>PHP include Example</title>
</head>
<body>
<h1>PHP include</h1>
<p>This shows how the PHP include construct works.</p>
<script src="public/js/app.js"></script>
</body>
</html>
Linguagem de código: HTML, XML ( xml )
PHP inclui e escopos variáveis
Quando você inclui um arquivo, todas as variáveis definidas nesse arquivo herdam o escopo da variável da linha na qual ocorre a inclusão.
1) Incluindo fora de um exemplo de função
Por exemplo, o seguinte define as variáveis $title
e $content
no functions.php
:
<?php
// functions.php
$title = 'PHP include';
$content = 'This shows how the PHP include construct works.';
Linguagem de código: HTML, XML ( xml )
Quando você inclui functions.php
no index.php
arquivo, as variáveis $title
e $content
se tornam as variáveis globais no index.php
arquivo. E você pode usá-los da seguinte maneira:
<?php include 'inc/header.php'; ?>
<?php include_once 'functions.php'; ?>
<h1><?php echo $title; ?></h1>
<p><?php echo $content; ?></p>
<?php include 'inc/footer.php'; ?>
Linguagem de código: HTML, XML ( xml )
2) Incluindo em um exemplo de função
No entanto, se você incluir um arquivo em uma função , as variáveis do arquivo incluído serão locais para essa função. Veja o exemplo a seguir:
<?php include 'inc/header.php'; ?>
<?php include_once 'functions.php'; ?>
<?php
function render_article()
{
include 'functions.php';
return "<article>
<h1>$title</h1>
$content
</article>";
}
echo render_article();
?>
<?php include 'inc/footer.php'; ?>
Linguagem de código: HTML, XML ( xml )
Neste exemplo, incluímos o functions.php
dentro da render_article()
função. Portanto, as variáveis $title
e $content
do functions.php
são locais para o render_function()
.
É importante observar que todas as funções , classes , interfaces e características definidas no arquivo incluído terão um escopo global.
Resumo
- Use a construção PHP
include
para carregar o código de outro arquivo de script.