Skip to content
PHP spell check library
Branch: master
Clone or download
icanhazstring Fix/backward compatibility (#14)
* Add backwards php7.1 and symfony/process ^3.4 support
* Readd travis matrix build
Latest commit 5d0a09c Jan 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples #6: Can't open affix or dictionary files for dictionary named "default". Mar 22, 2017
src Hunspell: fix Windows compatibility (#11) Jan 18, 2019
tests Update code Jan 17, 2019
.gitattributes Feature: Aspell custom dictionary (#13) Jan 17, 2019
.gitignore Feature: Aspell custom dictionary (#13) Jan 17, 2019
.travis.yml Fix/backward compatibility (#14) Jan 25, 2019 Feature: Aspell custom dictionary (#13) Jan 17, 2019
LICENSE Initial commit May 8, 2015
composer.json Fix/backward compatibility (#14) Jan 25, 2019
phpunit.xml.dist Feature: Aspell custom dictionary (#13) Jan 17, 2019


PHP spell check library.

Latest Stable Version License Build Status Coverage Status

Currently supported backends:


With Composer:

$ composer require mekras/php-speller


  1. Create a text source object from string, file or something else using one of the Mekras\Speller\Source\Source implementations (see Sources below).
  2. Create some speller instance (Hunspell, Ispell or any other implementation of the Mekras\Speller\Speller).
  3. Execute Speller::checkText() method.
use Mekras\Speller\Hunspell\Hunspell;
use Mekras\Speller\Source\StringSource;

$source = new StringSource('Tiger, tigr, burning bright');
$speller = new Hunspell();
$issues = $speller->checkText($source, ['en_GB', 'en']);

echo $issues[0]->word; // -> "tigr"
echo $issues[0]->line; // -> 1
echo $issues[0]->offset; // -> 7
echo implode(',', $issues[0]->suggestions); // -> tiger, trig, tier, tigris, tigress

You can list languages supported by backend:

/** @var Mekras\Speller\Speller $speller */

See examples for more info.

Source encoding

For aspell, hunspell and ispell source text encoding should be equal to dictionary encoding. You can use IconvSource to convert source.


This backend uses aspell program, so it should be installed in the system.

use Mekras\Speller\Aspell\Aspell;

$speller = new Aspell();

Path to binary can be set in constructor:

use Mekras\Speller\Aspell\Aspell;

$speller = new Aspell('/usr/local/bin/aspell');

Custom Dictionary

You can use a custom dictionary for aspell. The dictionary needs to be in the following format:

personal_ws-1.1 [lang] [words]

Where [lang] shout be the shorthand for the language you are using (e.g. en) and [words] is the count of words inside the dictionary. Beware that there should no spaces at the end of words. Each word should be listed in a new line.

$aspell = new Aspell();
$aspell->setPersonalDictionary(new Dictionary('/path/to/custom.pws'));


  • aspell allow to specify only one language at once, so only first item taken from $languages argument in Ispell::checkText().


This backend uses hunspell program, so it should be installed in the system.

use Mekras\Speller\Hunspell\Hunspell;

$speller = new Hunspell();

Path to binary can be set in constructor:

use Mekras\Speller\Hunspell\Hunspell;

$speller = new Hunspell('/usr/local/bin/hunspell');

You can set additional dictionary path:

use Mekras\Speller\Hunspell\Hunspell;

$speller = new Hunspell();

You can specify custom dictionaries to use:

use Mekras\Speller\Hunspell\Hunspell;

$speller = new Hunspell();
$speller->setCustomDictionaries(['tech', 'titles']);


This backend uses ispell program, so it should be installed in the system.

use Mekras\Speller\Ispell\Ispell;

$speller = new Ispell();

Path to binary can be set in constructor:

use Mekras\Speller\Ispell\Ispell;

$speller = new Ispell('/usr/local/bin/ispell');


  • ispell allow to use only one dictionary at once, so only first item taken from $languages argument in Ispell::checkText().


Sources — is an abstraction layer allowing spellers receive text from different sources like strings or files.


Reads text from file.

use Mekras\Speller\Source\FileSource;

$source = new FileSource('/path/to/file.txt');

You can specify file encoding:

use Mekras\Speller\Source\FileSource;

$source = new FileSource('/path/to/file.txt', 'windows-1251');


Use string as text source.

use Mekras\Speller\Source\StringSource;

$source = new StringSource('foo', 'koi8-r');

Meta sources

Additionally there is a set of meta sources, which wraps other sources to perform extra tasks.


Return user visible text from HTML.

use Mekras\Speller\Source\HtmlSource;

$source = new HtmlSource(
    new StringSource('<a href="#" title="Foo">Bar</a> Baz')
echo $source->getAsString(); // Foo Bar Baz

Encoding detected via DOMDocument::$encoding.


This is a meta-source which converts encoding of other given source:

use Mekras\Speller\Source\IconvSource;
use Mekras\Speller\Source\StringSource;

// Convert file contents from windows-1251 to koi8-r.
$source = new IconvSource(
    new FileSource('/path/to/file.txt', 'windows-1251'),


Loads text from XLIFF files.

use Mekras\Speller\Source\XliffSource;

$source = new XliffSource(__DIR__ . '/fixtures/test.xliff');

Source filters

Filters used internally to filter out all non text contents received from source. In order to save original word location (line and column numbers) all filters replaces non text content with spaces.

Available filters:

You can’t perform that action at this time.