Ficha prática 8 – Inclusão de ficheiros externos com include( ) ou required ( ) Podemos incluir ficheiros externos num script de PHP. Para isso, existem duas funções predefinidas de PHP: include() e required(). Os ficheiros externos chamados com estas funções, podem ser de PHP, HTML ou ambos. Este tipo de recurso de programação para páginas web costuma ser designado por SSI ou Server Side Includes. Utiliza-se bastante para evitar escrever o mesmo código para diferentes páginas de um site, que devem incluir partes comuns, como por exemplo, cabeçalhos, rodapés, menus, etc. Vamos supor que as várias páginas do nosso site deveriam incluir um menu com os seguintes links: Página principal Os nossos serviços Quem somos nós Contacte-nos Os itens deste menu poderiam ser apresentados na vertical ou na horizontal; vamos considerar neste caso, que vão ser expostos de forma horizontal e no topo das páginas. Módulo 788: Instalação e Administração de Servidores Web |Formando: Francisco Castro Page 1 Podemos criar um ficheiro, com o nome menu.php e o seguinte código: A seguir teremos um exemplo do código de uma página onde é feita a chamada ao ficheiro externo menu.php, com a função include(). Digite o seguinte código e grave com o nome teste9. Podemos ver o ficheiro criado com o nome menu.php e o teste9.php, que contém uma chamada àquele ficheiro externo, através da função include(). Módulo 788: Instalação e Administração de Servidores Web |Formando: Francisco Castro Page 2 Este documento é apenas um exemplo de uma página html, entre as várias que teríamos de criar para o nosso site. Nessas páginas seriam incluídos os conteúdos desejados. Para incluir também o referido menu, bastaria escrever em cada página, a seguinte instrução em php: <?php include(“menu.php”);?> Em vez desta instrução, também poderíamos utilizar a seguinte: <?php require(“menu.php”);?> As duas funções têm o mesmo objetivo, que é incluir ou chamar um ficheiro externo para o script corrente. Existe uma diferença entre elas apenas no que toca ao modo como reagem a uma situação de erro, por exemplo: Com a função include(), em caso de erro, surge uma mensagem a informar da situação, mas o resto do script continua em execução; Com a função required(), em caso de erro, também surge uma mensagem mas o script para de imediato a sua execução. Portanto, escolher uma ou outra função, depende do modo como queremos que o nosso script atue em situações de erro. Módulo 788: Instalação e Administração de Servidores Web |Formando: Francisco Castro Page 3