HtmlConverter

Biblioteca HtmlConverter da Bicpi

O HTMLConverter é uma biblioteca PHP que fornece conversão fácil de HTML para texto. Isso é útil, por exemplo, para criar automaticamente partes de texto simples dos emails HTML.

Uso

1. Crie conversor
2. Ligue para ->convert($html)
3. Desfrute de texto simples devolvido

SimpleConverter

O SimpleConverter funciona em todos os sistemas habilitados para PHP usando a função php's strip_tags() e colocando algumas entidades html decodificando na parte superior.

 <?php

use bicpi  HtmlConverter  Converter  SimpleConverter ;

$ html = ' ... <h1>... you HTML content ...</h1> ... ' ;
$ converter = new SimpleConverter ();
$ plain = $ converter -> convert ( $ html );

LynxConverter

O LynxConverter funciona em todos os sistemas com o pacote de navegador de texto lynx instalado. O texto simples convertido é equivalente ao que você veria ao abrir o HTML no lynx . Atualmente, este é o conversor mais útil, pois fornece os melhores resultados e inclui todos os links como referências.

 <?php

use bicpi  HtmlConverter  Converter  LynxConverter ;

$ html = ' ... <h1>... you HTML content ...</h1> ... ' ;
$ converter = new LynxConverter ();
$ plain = $ converter -> convert ( $ html );

Html2textConverter

O Html2TextConverter funciona em todos os sistemas com o pacote html2text instalado. O texto simples convertido é equivalente ao que você veria ao passar o HTML na linha de comando para o comando html2text . O resultado é bastante bom, mas esteja ciente de que os links serão removidos. Portanto, isso não deve ser usado para converter uma página da web inteira ou email de marketing. Pode ser útil para pequenos pedaços de código HTML.

 <?php

use bicpi  HtmlConverter  Converter  Html2TextConverter ;

$ html = ' ... <h1>... you HTML content ...</h1> ... ' ;
$ converter = new Html2TextConverter ();
$ plain = $ converter -> convert ( $ html );

ChainConverter

O ChainConverter oferece encadeamento de conversor para que o primeiro conversor apropriado lide com a conversão.

 <?php

use bicpi  HtmlConverter  Converter  ChainConverter ;
use bicpi  HtmlConverter  Converter  LynxConverter ;
use bicpi  HtmlConverter  Converter  SimpleConverter ;

$ html = ' ... <h1>... you HTML content ...</h1> ... ' ;
$ converter = new ChainConverter ();
$ converter -> addConverter ( new LynxConverter ());
$ converter -> addConverter ( new SimpleConverter ());
$ plain = $ converter -> convert ( $ html );

No exemplo acima, a conversão será tratada pelo LynxConverter - desde que o pacote lynx esteja disponível. Caso contrário, o SimpleConverter será usado como fallback. Por exemplo, isso seria útil ao implantar em uma máquina sem lynx instalado, mas uma máquina de desenvolvimento sem o pacote - por exemplo, Windows.

Testes de unidade em execução

Para configurar e executar os testes, siga estas etapas:

1. Vá para o diretório raiz desta biblioteca
2. Execute: composer install
3. RUN: ./vendor/bin/phpunit