Readability

Build Status Coverage Status

This is an extract of the Readability class from this full-text-rss fork. It can be defined as a better version of the original php-readability.

Differences

The default php-readability lib is really old and needs to be improved. I found a great fork of full-text-rss from @Dither which improve the Readability class.

  • I’ve extracted the class from its fork to be able to use it out of the box
  • I’ve added some simple tests
  • and changed the CS, run php-cs-fixer and added a namespace

But the code is still really hard to understand / read …

Requirements

By default, this lib will use the Tidy extension if it’s available. Tidy is only used to cleanup the given HTML and avoid problems with bad HTML structure, etc ..

Since Composer doesn’t support suggestion on PHP extension, I write this suggestion here.

Usage

use Readability\Readability;

$url = 'http://www.medialens.org/index.php/alerts/alert-archive/alerts-2013/729-thatcher.html';

// you can use whatever you want to retrieve the html content (Guzzle, Buzz, cURL ...)
$html = file_get_contents($url);

$readability = new Readability($html, $url);
// or without Tidy
// $readability = new Readability($html, $url, 'libxml', false);
$result = $readability->init();

if ($result) {
    // display the title of the page
    echo $readability->getTitle()->textContent;
    // display the *readability* content
    echo $readability->getContent()->textContent;
} else {
    echo 'Looks like we couldn\'t find the content. :(';
}

If you want to debug it, or check what’s going on, you can inject a logger (which must follow Psr\Log\LoggerInterface, Monolog for example):

use Readability\Readability;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$url = 'http://www.medialens.org/index.php/alerts/alert-archive/alerts-2013/729-thatcher.html';
$html = file_get_contents($url);

$logger = new Logger('readability');
$logger->pushHandler(new StreamHandler('path/to/your.log', Logger::DEBUG));

$readability = new Readability($html, $url);
$readability->setLogger($logger);

Related Repositories

php-readability

php-readability

Back the fun of reading - PHP Port of Arc90′s Readability ...

php-goose

php-goose

Readability / Html Content / Article Extractor & Web Scrapping library written in PHP ...

php-readability

php-readability

A fork of https://bitbucket.org/fivefilters/php-readability ...

laravel-readability

laravel-readability

Back the fun of reading - PHP Port of Arc90′s Readability ...

php-readability

php-readability

Back the fun of reading - PHP Port of Arc90′s Readability ...


Top Contributors

j0k3r

Releases

-   v1.0.9 zip tar
-   v1.0.8 zip tar
-   v1.0.7 zip tar
-   v1.0.6 zip tar
-   v1.0.5 zip tar
-   v1.0.4 zip tar
-   v1.0.3 zip tar
-   v1.0.2 zip tar
-   v1.0.1 zip tar
-   v1.0 zip tar
-   1.1.2 zip tar
-   1.1.1 zip tar
-   1.1.0 zip tar