Controle de saída em PHP II

Vejamos outras funcionalidades interessantes do controle da saída em PHP, para trabalhar com um buffer de saída. Eliminamos o buffer e executamos funções antes de mostrá-lo.

Continuamos explorando algumas utilidades interessantes de PHP para realizar controle de saída, através de um buffer, para não enviar ao cliente o código HTML gerado por PHP até que o programador o deseje.

Este artigo continua com o outro anterior publicado em CriarWeb.com: Controle de saída em PHP.

Agora vamos aprender a eliminar ou cancelar uma saída armazenada em um buffer e a executar funções para realizar um processamento do código armazenado em um buffer antes de enviá-lo ao cliente. Para isso, vamos conhecer novas funções:

A função ob_clean() limpa o buffer de saída. Isso quer dizer que o que tivermos no buffer de saída se perderá.

A função ob_end_clean() serve para limpar o buffer de saída e ademais desabilitá-lo. Ou seja, termina de trabalhar com o buffer e ainda descarta todas as mudanças que tiverem sido incluídas no buffer.

Também utilizaremos um parâmetro que não tínhamos visto da função ob_start(parâmetro). Esse parâmetro serve para indicar o nome de uma função que será chamada antes de enviar o buffer de saída ao cliente.

Vejamos este código, que faz uso das novas funções e vamos explicando a seguir passo a passo.

<html>
<head>
   <title>Página processada com buffer de saída</title>
</head>
<body>
<?
//inicio o buffer de saída
ob_start();

echo "Oi!!! Isto vai ao buffer!";

//limpo o buffer de saída
ob_clean();

echo "Outra vez escrevo!!";

//limpo o buffer de saída e o desabilito
ob_end_clean();

echo "Isto sim que vai aparecer na página<br>";

function converte_caracteres_especiais($buffer){
   return htmlentities ($buffer);
}

//inicio o buffer de saída
ob_start("converte_caracteres_especiais");

echo "Tinha que provar mais coisas. Espero que se leia com interesse.";

ob_end_flush();
?>
</body>
</html>

Com ob_start(); iniciamos o buffering da saída. A partir de agora tudo o que se escrever na página se salvará no burffer. Portanto, o seguinte echo "Oi!!! Isto vai ao buffer!"; se salvará no buffer.

Com a linha ob_clean(); se apaga o conteúdo do buffer, por isso a saída armazenada se perde. Ou seja, o echo anterior não se mostrará na página.

O buffer, apesar de estar recém limpo, continua ativo. Por isso com o echo "Outra vez escrevo!!";, o texto continuará inserindo-se no buffer.

Logo, com a linha ob_end_clean(); se apaga o conteúdo do buffer e se desabilita. Perdemos outra vê tudo que tiver sido escrito na página a partir do início de uso do buffer, portanto o anterior echo não se mostrará.

Na seguinte linha fazemos um echo "Isto sim que vai aparecer na página<br>"; Como tínhamos desabilitado anteriormente o buffer com ob_end_clean(), esse texto se irá direto à saída e chegará ao navegador que solicitou a página.

Logo no código vemos uma declaração de uma função:

function converte_caracteres_especiais($buffer){
   return htmlentities ($buffer);
}

Utilizaremos esta função para executá-la antes de enviar o buffer ao cliente. Recebe um parâmetro que é o buffer que se está processando. Dentro da função se podem realizar ações e se deve devolver um valor, que será o que definitivamente se envie ao navegador do visitante.

Para dizer ao PHP que se deve executar essa função antes de enviar o buffer ao cliente se deve iniciar o uso do buffer ob_start(parâmetro), com o parâmetro que é o nome da função, tal como comentamos antes.

ob_start("converte_caracteres_especiais");

O seguinte echo "Tinha que provar mais coisas. Espero que se leia com interesse."; se coloca no buffer. E finalmente com ob_end_flush(); se envia o buffer ao cliente.

Como ao iniciar o buffer havia sido indicado um parâmetro com o nome da função converte_caracteres_especiais() se executará essa função antes de enviar o conteúdo ao cliente web.

Nesse função simplesmente se processa o buffer, convertendo os caracteres especiais que tiver em seus correspondentes códigos especiais de HTML, com htmlentities().

Portanto, o texto que se enviará ao cliente é o texto que tiver no buffer depois de executar htmlentities().

Conclusão e resultado do controle de saída de PHP

Para acabar, podemos ver o código que se geraria e se enviaria ao cliente como resultado do processamento dessa página.

<html>
<head>
   <title>Página processada com buffer de saída</title>
</head>
<body>
Isto sim que vai aparecer na página<br><br>Tinha que provar mais coisas. Espero que se leia com interesse.</body>
</html>