j0k3r/php-readability

Automatic article extraction from HTML

Tuesday, June 5, 2018
by j0k3r
Repository
8 Watchers
106 Stars
41,208 Installations

PHP
3 Dependents
0 Suggesters
28 Forks
3 Open issues
22 Versions
6 % Grown

The README.md

Readability

, _(*1)

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., _(*2)

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., _(*3)

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 ..., _(*4)

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 .. It'll be suggested by Composer., _(*5)

Also, if you got problem from parsing a content without Tidy installed, please install it and try again., _(*6)

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):, _(*7)

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);

The Versions

05/06 2018

dev-master

9999999-dev

Automatic article extraction from HTML

library php-readability

Automatic article extraction from HTML

j0k3r/php-readability

The README.md

Readability

Differences

Requirements

Usage

The Versions

dev-master

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.10

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.9

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.8

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.7

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.6

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.5

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.4

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.3

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.2

The Requires

The Development Requires

by Jeremy Benoist

by Keyvan Minoukadeh

by Arc90

by DitherSky

1.1.1