davechild/textstatistics

PHP package to measure the readability of text according to various algorithms.

1.0.3 2018-08-21 08:17 UTC

Requires

• php: >=7.2.0

Requires (Dev)

• phpunit/phpunit: ^7

Suggests

• ext-bcmath: More accurate floating point calculations.
• ext-mbstring: Handle multi-byte text properly.

BSD-2-Clause

• Dave Child

README

The PHP Text Statistics class will help you to indentify issues with your website content, especially with readability.

It allows you to measure the readability of text using common scoring systems, including:

• Flesch Kincaid Reading Ease
• Flesch Kincaid Grade Level
• Gunning Fog Score
• Coleman Liau Index
• SMOG Index
• Automated Reability Index
• Dale-Chall Readability Score
• Spache Readability Score

One of the biggest challenges with measuring text readability is the counting of syllables, which can be tricky to work out. There are rules in the Statistics class for working out the syllable count of words, and a large list of words to test these rules against.

Please feel free to add to the test word list, especially if you can find words whose syllable count is not correctly calculated (even more especially if you can also add code to the class so your word is correctly handled!).

Homographs are going to be impossible to calculate as they depend on context (i.e., "he moped around the house", "she rode her moped to school), but there are few enough of these not to be a concern. There is a by-no-means-comprehensive list of these in the resources folder.

Installation

Using Composer

    {
        "require": {
            "davechild/textstatistics": "1.*"
        }
    }

If using a version of PHP < 7.2, specify version 1.0.2.

Measuring Readability

use DaveChild\TextStatistics as TS;
$textStatistics = new TS\TextStatistics;
$text = 'The quick brown fox jumped over the lazy dog.';
echo 'Flesch-Kincaid Reading Ease: ' . $textStatistics->fleschKincaidReadingEase($text);

More Text Shenanigans!

Included with this package are several classes with static methods which can be called independently. If required, you can pass a text encoding to these methods as a second parameter.

Pluralise and Singularise Words

echo DaveChild\TextStatistics\Pluralise::getPlural('banana'); // bananas
echo DaveChild\TextStatistics\Pluralise::getSingular('bananas'); // banana

Count Syllables

echo DaveChild\TextStatistics\Syllables::syllableCount('banana'); // 3

Letter, Sentence, Word Counts

echo DaveChild\TextStatistics\Text::textLength('I ate a banana.'); // 15
echo DaveChild\TextStatistics\Text::letterCount('I ate a banana.'); // 11
echo DaveChild\TextStatistics\Text::wordCount('I ate a banana.'); // 4
echo DaveChild\TextStatistics\Text::sentenceCount('I ate a banana.'); // 1

Useful Links

Homepage and Live Version

https://readable.com/

JavaScript Port

https://github.com/cgiffard/TextStatistics.js

License

http://www.opensource.org/licenses/bsd-license.php