Resumo : neste tutorial, você aprenderá como incluir código de um arquivo usando a includeconstrução PHP.
Introdução ao PHP inclui construção
A includeconstrução permite carregar o código de outro arquivo em um arquivo. Aqui está a sintaxe da includeconstrução:
include 'path_to_file';Linguagem de código: PHP ( php )Nesta sintaxe, você coloca o caminho para o arquivo após a includepalavra-chave. Por exemplo, para carregar o código de um functions.phparquivo em um index.phparquivo, você pode usar a seguinte includeinstruçã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 srcdiretó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 4Linguagem de código: PHP ( php )Ao carregar o functions.phparquivo, o PHP primeiro procura o functions.phparquivo no diretório especificado pela extensão include_path. Neste exemplo, é '\xampp\php\PEAR'. Se o PHP puder encontrar o functions.phparquivo lá, ele carregará o código do arquivo.
Caso contrário, o PHP pesquisa o functions.phparquivo no diretório do script de chamada e no diretório de trabalho atual. Se o PHP conseguir encontrar o functions.phparquivo lá, ele carrega o código. Caso contrário, emite um aviso se o arquivo não existir.
Quando o PHP carrega o functions.phparquivo, ele na verdade executa o código dentro do functions.phparquivo. Por exemplo, se você colocar o seguinte código no functions.phparquivo:
<?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.phparquivo index.php, você verá a seguinte saída ao executar o index.phparquivo:
Copyright © 2021 by phptutorial.net. All Rights Reserved!Linguagem de código: CSS ( css )Isso demonstrou que a includeconstrução faz com que o PHP execute o código no functions.phparquivo.
PHP inclui exemplo
Na prática, você usará frequentemente a includeconstruçã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.phpe, footer.phpe incluí-los nas páginas.
Normalmente, você coloca os arquivos de modelo como header.phpe footer.phpem um diretório separado. Por convenção, o nome do includediretório é inc:
.
├── index.php
├── functions.php
├── inc
│ ├── footer.php
│ └── header.php
└── public
├── css
│ └── style.css
└── js
└── app.jsLinguagem de código: CSS ( css )O header.phparquivo contém o código do cabeçalho da página. Possui um link para o style.cssarquivo localizado no public/cssdiretó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.phparquivo 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.phparquivo, você pode incluir o arquivo header.phpe footer.phpassim:
<?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.phparquivo e visualizar o código-fonte da página, também verá o código dos arquivos header.phpe :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 $titlee $contentno 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.phpno index.phparquivo, as variáveis $titlee $contentse tornam as variáveis globais no index.phparquivo. 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.phpdentro da render_article()função. Portanto, as variáveis $titlee $contentdo functions.phpsã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
includepara carregar o código de outro arquivo de script.
