Find and Correct Misspelled Words with Pspell

Share this article

Every one of us has made a spelling mistake in a Google search: “alternitive music”, for example. In doing so, you may have noticed that Google was trying to help you by displaying: “Did you mean alternative music?”. If your site has a search function, to indicate misspellings if no or too few results have been found is a very useful feature, especially if the bad English of a visitor can make you miss a sale. Fortunately, PHP’s Pspell module allows for checking the spelling of a word and suggesting a replacement from its default dictionary (you can also create a custom dictionary).

To begin, we need to check if Pspell is installed:

$config_dic= pspell_config_create ('en');

If you get an error, it isn’t. On Linux systems, follow these instructions to solve the problem.

Use the default dictionary

Here is a small function to help you understand how Pspell works:

function orthograph($string)
    // Suggests possible words in case of misspelling
    $config_dic = pspell_config_create('en');

    // Ignore words under 3 characters
    pspell_config_ignore($config_dic, 3);

    // Configure the dictionary
    pspell_config_mode($config_dic, PSPELL_FAST);
    $dictionary = pspell_new_config($config_dic);

    // To find out if a replacement has been suggested
    $replacement_suggest = false;

    $string = explode('', trim(str_replace(',', ' ', $string)));
    foreach ($string as $key => $value) {
        if(!pspell_check($dictionary, $value)) {
            $suggestion = pspell_suggest($dictionary, $value);

            // Suggestions are case sensitive. Grab the first one.
            if(strtolower($suggestion [0]) != strtolower($value)) {
                $string [$key] = $suggestion [0];
                $replacement_suggest = true;

    if ($replacement_suggest) {
        // We have a suggestion, so we return to the data.
        return implode('', $string);
    } else {
        return null;

To use this function, it is sufficient to pass to it a string parameter:

$search = $_POST['input'];
$suggestion_spell = orthograph($search);
if ($suggestion_spell) {
    echo "Try with this spelling : $suggestion_spell";

If the string you submit to Pspell is “here is my mispellid word”, the previous script will return: “Try with this spelling: Here is my misspelled word.” However, Pspell is no miracle worker, especially if you’re automatically using the first suggested spelling alternative! For best results, you can use all the suggestions offered by Pspell. The following script returns twenty proposals around the word “lappin”:

$dict = pspell_new ("en");
if (!pspell_check ($dict, "lappin")) {
    $suggestions = pspell_suggest ($dict, "lappin");
     foreach ($suggestions as $suggestion) {
        echo "Did you mean: $suggestion?<br />";

You must configure a dictionary to initialize Pspell. To do this, create a descriptor toward a configuration file of the dictionary, change some options of this descriptor, then use the configuration dictionary to create a second descriptor for the real dictionary. If this sounds a bit complicated, do not worry: The code rarely changes and you can usually copy it from another script. However, here we will study it step by step. Here is the code that configures the dictionary:

    // Suggests possible words in case of misspelling
    $config_dic = pspell_config_create('en');

    // Ignore words under 3 characters
    pspell_config_ignore($config_dic, 3);

    // Configure the dictionary
    pspell_config_mode($config_dic, PSPELL_FAST);

$config_dic is the initial template which controls the options for your dictionary. You must load all the options in $config_dic, then use it to create the dictionary. pspell_config_create() creates an English dictionary (en). To use the English language and specify that you prefer American spelling, specify ‘en’ as the first parameter and ‘american’ as the second. pspell_config_ignore() indicates that your dictionary will ignore all words of 3 letters or less. Finally, pspell_config_mode() indicates to Pspell the operating mode:

• PSPELL_FAST is a quick method that will return the minimum of suggestions. • PSPELL_NORMAL returns an average number of suggestions at normal speed. • PSPELL_SLOW provides all possible suggestions, although this method takes some time to perform the spell check. We could still use other configuration options (to add, for example, a custom dictionary, as we shall see later), but as this is a quick check, we will simply create the dictionary with this line:

    $dictionary = pspell_new_config($config_dic);

From this point you can use the dictionary in two ways: 1. pspell_check($dictionary, "word") returns true if “word” is in the dictionary. 2. pspell_suggest($dictionary, "word") returns an array of suggested words if “word” is not in the dictionary (the first element of this array is the most likely candidate). The number of words obtained varies, but you get more with PSPELL_SLOW and fewer with PSPELL_FAST.

Now that the dictionary is ready, we cut the string that was passed as a parameter to obtain an array of words: ‘here my sentence‘ becomes an array of three elements, “here”, “my”, and “sentence”. Then we check the spelling of each word using the default dictionary. Because it does not like commas, we also delete them before exploding the string. If the word has more than three characters, verification takes place and in case of misspelling, we conduct the following operations:

  1. We ask Pspell to provide an array of suggestions for correction.
  2. We take the most likely suggestion (the first element of the array $suggestion) and we replace the misspelled word with it.
  3. We set the $replacement_suggest flag to true so that at the end of the processing loop, we know that we have found a spelling mistake somewhere in $string. At the end of the loop, if there were spelling corrections, we are reforming the string from elements of the corrected array and we return this chain. Otherwise, the function returns null to indicate that it has not detected misspelling.

Add a custom dictionary to Pspell

If a word is not in the default dictionary, you can easily add it. However, you can also create a custom dictionary to be used with the default. Create a directory on your site where PHP has the right to write and initialize the new dictionary in it. To create a new dictionary file called perso.pws in the directory path of your server, use the following script:

$config_dic = pspell_config_create ('en');
pspell_config_personal($config_dic, 'path / perso.pws');
pspell_config_ignore($config_dic , 2);
pspell_config_mode($config_dic, PSPELL_FAST);
$dic = pspell_new_config($config_dic);

This is the same script as in the previous section, but with an essential addition: calling pspell_config_personal() initializes a personal dictionary file. If this file does not already exist, Pspell creates a new one for you. You can add to this dictionary as many words as you want by using the following function:

`pspell_add_to_personal($dic, "word");`

As long as you have not saved the dictionary, words are added to it temporarily. Therefore, after inserting the words you want, add this line to the end of the script:


Then call pspell_config_personal() as above in the demo script and your new dictionary will be ready.


Pspell can help you with your conversion rate by providing your visitors with a way to automatically correct and notice their typos. It can enhance search experiences, forum submissions, and general linguistic accuracy of a web site with user submitted content. If you’d like to take a deeper look at Pspell, or have implemented it in an interesting manner, let us know in the comments below!

Frequently Asked Questions (FAQs) about Correcting Misspelled Words

How does a spell checker work?

A spell checker works by comparing each word in a text to a dictionary of correctly spelled words. If a word in the text is not found in the dictionary, it is flagged as potentially misspelled. Some spell checkers also check for common typing errors, grammatical errors, and can suggest corrections. They can be standalone applications or integrated into other software like word processors or web browsers.

What is Pspell and how does it help in finding misspelled words?

Pspell is a PHP extension for spell checking. It uses the Pspell library, which is a part of the GNU Aspell project. Pspell can suggest corrections for misspelled words, making it a useful tool for applications that involve text input, like content management systems or webmail applications.

How can I use Pspell in my PHP project?

To use Pspell in your PHP project, you first need to install the Pspell extension. Once installed, you can use the Pspell functions to check spelling and suggest corrections. The Pspell functions are easy to use and well-documented, making it straightforward to integrate spell checking into your project.

Can I use Pspell for languages other than English?

Yes, Pspell supports multiple languages. You can specify the language when you create a new Pspell dictionary. The Pspell library includes dictionaries for many languages, and additional dictionaries can be installed if needed.

How can I handle common typing errors with Pspell?

Pspell can suggest corrections for common typing errors, like transposed letters or missing letters. You can control the suggestions by adjusting the Pspell configuration. For example, you can set Pspell to suggest corrections that are close to the misspelled word in terms of the number of changed, added, or deleted letters.

What are the limitations of Pspell?

While Pspell is a powerful tool for spell checking, it does have some limitations. It does not check grammar or context, so it may not catch errors like using the wrong word in a sentence. Also, it may not recognize some specialized or technical terms that are not in its dictionary.

How can I improve the accuracy of Pspell?

You can improve the accuracy of Pspell by adding words to its dictionary. This can be useful for specialized or technical terms that Pspell does not recognize. You can also adjust the Pspell configuration to better match your needs, like setting it to suggest more or fewer corrections.

Can I use Pspell for SEO purposes?

Yes, Pspell can be used for SEO purposes. By ensuring that your content is free of spelling errors, you can improve its readability and credibility, which can help with SEO. Also, Pspell can help you identify common misspellings of keywords, which you can use to optimize your content for search.

How does Pspell compare to other spell checkers?

Pspell is a powerful and flexible spell checker, but it may not be the best choice for all situations. Other spell checkers, like the ones integrated into word processors or web browsers, may be more convenient for casual use. However, for applications that require a high degree of control over spell checking, like content management systems or webmail applications, Pspell can be an excellent choice.

Is Pspell free to use?

Yes, Pspell is free to use. It is a part of the GNU Aspell project, which is open source and freely available. However, using Pspell in a commercial product may require compliance with the terms of its license.

Adrien Tchuya PayongAdrien Tchuya Payong
View Author
languagemisspelled wordsmisspellingPHPpspsellspellingsuggest alternative spelling
Share this article
Read Next
Get the freshest news and resources for developers, designers and digital creators in your inbox each week
Loading form