Para começar, gostaria de dizer que a instrução include foi construída no PHP para que os desenvolvedores web economizem um punhado de tempo ao fazerem suas aplicações. O que vamos ver neste tutorial é a forma como usamos o include para duplicar tarefas repetitivas, limpar o código e, em geral ampliar nossos conhecimentos sobre a linguagem PHP. Vamos lá!
Tutorial de include PHP – Noções básicas
Devemos levar em consideração que, assim como a declaração echo do PHP, include não é considerado uma função real. Embora não se comportem como uma função, chamamos de construtor na linguagem, uma vez que é “incorporado” pelo PHP. Consideramos que é parte integrante da linguagem bem como o IF! (Você pode notar algumas construções de linguagem listadas como funções, mas isso é apenas para melhorar a documentação.)
O uso primário deste construtor em particular, é recuperar um arquivo remoto para inclusão no script atualmente em execução. Vamos usar o construtor include, por três razões principais:
- Legibilidade – Usamos o construtor include para substituir muitas linhas de código em apenas uma linha. Isso aumenta a capacidade de leitura de um aplicativo e, finalmente, permite-nos solucionar bugs mais rápido do que nunca.
- Economia de tempo – Economizamos tempo usando construtores include () de uma maneira inteligente. Se fôssemos alterar um link em um menu de navegação, teríamos de atualizar centenas de links ao mesmo tempo em diferentes subpáginas. Mas, ao usarmos um construtor include (), poderemos apenas editar um arquivo e os resultados em outras páginas seriam instantâneos!
- Confiabilidade – Se um arquivo incluído não existe ou não está funcionando, o servidor irá nos avisar muito rapidamente. Isso é excelente para solução de problemas! Relatórios de erros às vezes são vistos como um risco de segurança, no entanto, precisamos deles para encotrar erros.
Tutorial de include PHP – Exemplo de como incluir um arquivo
Antes de fazermos um exemplo, precisamos aprender como funciona a sintaxe de inclusão. Usar o construtor include é realmente muito fácil, nós só precisamos saber a URL do código de entrada, escrevê-la entre parênteses, e adicionar o include.
<?php
include("header.php");
include 'footer.php';
// As duas formas estão corretas, mas o primeiro exemplo é o mais indicado
?>
No exemplo acima, estamos chamando dois arquivos diferentes, onde ambos estão localizados no mesmo diretório que a página que está sendo visualizada. As duas formas funcionam, mas, pessoalmente, prefiro o primeiro exemplo, uma vez que fica mais legível.
Se o arquivo que queria incluir estiver no diretório pai ou acima, simplesmente use a notação “../” como pode ser visto abaixo.
<?php
include("../header.php");
// Inclua um arquivo de um diretório pai ou acima
?>
Observe que cada vez que usamos a notação “../” subimos um nível. Mas as coisas não precisam ficar complicadas! Podemos simplificar as coisas simplesmente usando a URL inteira como visto abaixo:
<?php
include("http://www.SuaUrl.com/includes/header.php");
// Inclusão fácil de arquivo
?>
Tutorial de include PHP – Exemplo de include
Para começar, vamos precisar de pelo menos dois arquivos. Primeiro, vamos dar um arquivo chamado index.php já feito como visto abaixo:
<html> <title>Um Site PHP Básico Usando Include</title> <p style="text-align: center;padding: 10px;"> <a href="#">Home</a> <a href="#">Sub 1</a> <a href="#">Sub 2</a> </p> <p style="text-align: center;border: 1px dotted blue;">Seja bem-vindo ao nosso website! Os links acima estão sendo usados em <em>includes</em> - economizando nosso tempo para usarmos em ferramentas para este website.</p> </body> </html>
Agora crie um arquivo chamado “header.php” em outra janela. Vamos tirar alguns dos conteúdos do arquivo index.php e substituí-lo com a nossa instrução include. Nosso arquivo header.php deverá ser parecido com o seguinte:
<?php <a href="#">Home</a> <a href="#">Sub 1</a> <a href="#">Sub 2</a> ?>
Agora temos dois arquivos separados. Mas temos um problema, onde incluiremos a URL do arquivo header.php dentro do arquivo index.php? Simples! Revise o código abaixo para ver onde vamos colocar o include:
<html>
<title>Um Site PHP Básico Usando Include</title>
<p style="text-align: center;padding: 10px;">
<?php include("header.php"); ?>
</p>
<p style="text-align: center;border: 1px dotted blue;">Seja bem-vindo ao nosso website! Os links acima estão sendo usados em <em>includes</em> - economizando nosso tempo para usarmos em ferramentas para este website.</p>
</body>
</html>
Agora faça o upload dos arquivos para um mesmo diretório e teste! Se você quiser, pode alterar todo o conteúdo do arquivo header.php, faça o upload para o servidor web, e veja as alterações em tempo real. Isso pode não parecer uma grande economia de tempo com apenas uma página, mas se tivéssemos um site com 100 páginas, a economia de tempo para fazer manutenções seria enorme!
Tutorial de include PHP – Lidando com o escopo das variáveis
O escopo de variáveis soa como uma frase que não significa nada para quem não sabe o que é. O escopo de uma variável é o quão longe ele “chega” – ou, basicamente, onde ele pode ou não ser acessada. O escopo de variáveis pode ser visto quando se olha para dois scripts PHP separados. Se eles não estão ligados de alguma forma, então as variáveis do primeiro script não irão interferir com as variáveis do segundo. (E vice-versa).
Nós lidamos com o escopo no construtor include simplesmente porque estamos fazendo fusão de dois arquivos, então se nós estamos usando o mesmo nome de variável em ambos os scripts, quem recebe uma prioridade?
Em nosso exemplo anterior, não estamos lidando com escopo, uma vez que não estamos usando todas as variáveis. Mas podemos mudar isso com as seguintes edições em index.php e header.php:
<?php $home = "<a href='#'>Home<a>"; $sub1 = "<a href='#'>Sub 1<a>"; $sub2 = "<a href='#'>Sub 2<a>"; ?>
Declaramos as nossas três variáveis como os nossos links, para que possamos ver quais variáveis terão prioridade em nosso arquivo index.php. Nosso arquivo index.php deve ser atualizado conforme visto abaixo:
<html>
<title>Um Site PHP Básico Usando Include</title>
<body>
<p style="text-align: center;padding: 10px;">
<?php
$home = "";
$sub1 = "";
$sub2 = "";
include("header.php");
echo "$home $sub1 $sub2";
?>
</p>
<p style="text-align: center;border: 1px dotted blue;">Seja bem-vindo ao nosso website! Os links acima estão sendo usados em <em>includes</em> - economizando nosso tempo para usarmos em ferramentas para este website.</p>
</body>
</html>
Então, o que você acha que o script escreverá no browser? Como você pode ver, cada variável é declarada como uma string vazia antes de incluir o arquivo. Mas ao incluir o arquivo, afirmamos que as variáveis devem conter links.
Ao testar esse script, podemos ver que a saída vai mostrar os links de navegação corretamente. A partir desse exemplo, percebemos que um arquivo incluído irá realmente substituir os valores das variáveis, salvo se estiverem codificados.
Também deve ficar claro que um arquivo incluso só vai ter acesso às variáveis e funções que tenham sido declarados antes da linha usada para incluir o arquivo. No exemplo a seguir vamos declarar uma variável e fazer referência a ela dentro do arquivo de inclusão. (Não há necessidade de testar isto a menos que você queira, você pode facilmente ver os resultados com os dois pequenos trechos abaixo)
<?php
//index.php
$hello = "olá mundo!";
include("echo.php");
?>
<?php //echo.php echo $hello; ?>
Uma vez que esse script seja executado, veremos que “Olá mundo!” É a saída para a tela. Se tivéssemos de colocar a variável após a inclusão da linha, não teríamos nenhum resultado.
Tutorial de include PHP – Dois importantes problemas de segurança
O PHP é considerado uma linguagem segura, pois esconde o conteúdo do código do usuário. (Vá em frente, veja ocódigo-fonte do HTML das páginas que criamos, você não vai ver o código PHP!). Se não existisse esta proteção, qualquer um poderia ver o conteúdo de nossos scripts.
Às vezes, é comum vermos alguns programadores utilizando texto simples ou até mesmo um tipo de arquivo .INC em seus includes. Se você usar a extensão errada ou remover as tags PHP do arquivo header.php que estávamos trabalhando, você notará que o texto simples é a saída para a tela se você tentar acessar diretamente header.php. Isso mostra que quando usamos includes, devemos lembrar sempre de usar as tags PHP para incluir os dados se estiverem usando qualquer tipo de dados sensíveis.
Espero estar ajudando aos programadores iniciantes no PHP com este tutorial. Qualquer dúvida, pergunte nos comentários.
Me siga no Twitter para ficar por dentro das novidades do blog.
Outros Posts
Tags: comando include php, include css javascript, include header php, include html, include include_once php, include php, include php script, include string php, require php
Legal ou Bobagem:
0 
0
Legal ou Bobagem:
0 
0
a
b
c
d
e
f
g
como converto o menu em includes para abrir nessa mesmo iframe “main” ??
obrigado!
Legal ou Bobagem:
0 
1