Classe PHP Page Header para criar cabeçalhos de documentos web

Estudamos a classe Page Header, que nos permite gerar as típicas etiquetas utilizadas no HTML no cabeçalho do documento, bem como diversos cabeçalhos do HTTP.

Por Sara Alvarez Langa - Tradução de Celeste Veiga


Publicado em: 20/5/11
Valorize este artigo:
Uma das vantagens de PHP é que existem várias classes, pacotes e programas prontos para serem usados em projetos, que nos podem facilitar muitas das tarefas que tecnicamente podem ser mais complicadas. Prova disso é PHP Page Header, uma classe de Programação Orientada a Objetos que nos pode ajudar em uma tarefa muitas vezes pouco conhecida pelos desenvolvedores.

No artigo analisaremos Page Header, uma classe desenvolvida em PHP 5 que permite criar cabeçalhos de documentos web e cabeçalhos do HTTP. Esta classe nos permite realizar muitas coisas, como por exemplo:

  • Formar o cabeçalho com : título, descrição, palavras chave, robots, favicon, includes de arquivos Javascript, folhas de estilo, etc.
  • Acrescentar informação como a data de criação, modificação, etc.
  • Evitar o armazenamento em cache, ou forçá-lo
  • Especificar o tipo de documento, a codificação, etc.
  • Definir os parâmetros de acesso permitido aos robots de indexação, como Googlebot ou msnbot.
  • Criar e enviar cabeçalhos do HTTP de diferentes tipos, como especificar o MimeType ou realizar a configuração para o download de arquivos, para conseguir coisas como forçar o navegador a baixar sempre os arquivos em vez de executá-los.
Uma vez que ficou clara a utilidade desta classe que, diga-se de passagem, é muito interessante para qualquer projeto que possamos realizar, passemos a analisar o modo de trabalho que teremos que implementar para aproveitar suas utilidades.

Começamos por dar em o link para o download da classe, através do site PHPclasses.

Uma vez baixado, o único que temos que fazer é incluir a classe nos arquivos PHP em que vamos utilizá-la. Depois, teremos que instanciar um objeto da classe PageHeader e a partir de então alterar suas propriedades e invocar seus métodos para conseguir colocar em funcionamento as diferentes funcionalidades que nos oferece.

Exemplo 1: Page Header para criar cabeçalhos do documento HTML

A seguir, dou um pequeno exemplo de utilização de Page Header, que espero que sirva para entender como trabalhar com a mencionada classe. Vejamos o seguinte código:

<?php
require_once('pageheader.class.php');

//Criamos a instancia e lhe passamos o título da página
$header = new PageHeader("Titulo_pagina");

//Acrescentamos os parâmetros por padrão do cabeçalho.
$header->addDefaults();

//Acrescentamos descrição e keywords
$header->Description = "descrição";
$header->Keywords = "palavras chave separadas por vírgulas";

//Acrescentamos o favicon
$header->Favicon = 'favicon.ico';

//Acrescentamos a folha de estilo
$header->addStyle('estilo.css', false);

//acrescentamos os arquivos javascript.
$header->addScript('jquery.js', true);

//Criamos o cabeçalho
$header->write();
?>
<body>
Este é o corpo de nosso documento web com o cabeçalho criado mediante Page Header
</body>
</html>

Como vocês podem ver, o exemplo é simples e permite criar os cabeçalhos com todos os dados que você possa necessitar, desde o título e a descrição, até os estilos e arquivos Javascript que você possa estar utilizando em seu projeto.

As linhas que são imprescindíveis sempre são a do require_once com a localização da classe, a instancia da classe e a criação do cabeçalho.

Exemplo 2: Page Header para obrigar o download de um arquivo

Como havíamos dito, Page Header também permite gerar e enviar cabeçalhos do HTTP para realizar algumas coisinhas. Por exemplo, vamos dar um exemplo de uso desta classe no que se inicie o download de um arquivo através do navegador. Ou seja, em vez de escrever os cabeçalhos do documento HTML, se criarão e enviarão os cabeçalhos ao navegador para baixar um arquivo que nós configuramos.

<?php
require_once('pageheader.class.php');

// instanciamos um objeto da classe
$header = new PageHeader();

// Prevenir o caché
$header->addDefaults();

//forçar o download de um arquivo
$header->forceDownload( "js/jquery-1.4.2.min.js" );
//o navegador fará com que saia a janela de diálogo para baixar arquivo
//em vez de mostrá-lo como se fosse um conteúdo, na propria página
?>

Conclusão sobre Page Header

Como vimos, trata-se de uma classe bastante simples, porém também bastante útil. Talvez os exemplos e a documentação desta classe oferecidos no arquivo para baixar não sejam muito amplos, mas pelo menos podemos ver que as funcionalidades são bastante fáceis de implementar.

Existem mais opções para configurar no cabeçalho que não vimos neste artigo, como acrescentar a configuração dos robots de indexação. Porém, se você quiser, pode abrir o arquivo pageheader.class.php para obter mais informação sobre as possibilidades e usos desta classe PHP.





Comentários do artigo
Foi enviado 1 comentário ao artigo
1 comentário revisado:
Otimo!
Por: jean-|icezinho
05/8/11
Muito bom o artigo, baixei a classe e estou utilizando, recomendo a todos!

Usuários :    login / registro

Manuais relacionados
Categorias relacionadas
O autor

Home | Sobre nós | Copyright | Anuncie | Entrar em contato