Resolving 'Module Not Installed or Disabled' Warnings in Health Check
Content
If you use the Health Check & Troubleshooting plugin, you may have encountered a confusing warning stating that a PHP module like imagick, mcrypt, or zip is "not installed, or has been disabled." This is a common point of confusion for many WordPress users. This guide will explain why these messages appear and how to resolve them.
Why Do These Warnings Appear?
The plugin performs checks based on recommendations from the WordPress hosting community. Its goal is to help you configure your server for optimal WordPress performance and compatibility. However, these checks can sometimes be outdated or report false positives due to several reasons:
- Outdated Plugin Checks: Older versions of the plugin contained checks for deprecated modules like
mcrypt, which was removed in PHP 7.2. These have since been fixed in updates. - PHP Version Changes: When you upgrade your PHP version (e.g., from 7.2 to 7.3 or 8.0), you often need to re-enable extensions for the new specific PHP version. An extension enabled for PHP 7.2 will not automatically be enabled for PHP 7.3.
- Incorrect Severity: Some modules, like
imagick, are optional for WordPress, which can use the GD library instead. Earlier plugin versions incorrectly flagged the missingimagickmodule as a "critical issue" instead of a recommendation. - Core Limitations: The method the plugin uses to detect enabled modules can sometimes fail to read local PHP configuration values from files like
.user.ini, showing only the master values from the mainphp.ini.
How to Troubleshoot and Fix the Warnings
Here are the most common solutions, starting with the simplest.
1. Update the Plugin
First, ensure you are running the latest version of the Health Check & Troubleshooting plugin. The development team has fixed many of these inaccurate warnings over time, including typos and deprecated checks for modules like mcrypt.
2. Enable the Extension in Your Hosting Control Panel (cPanel, Plesk, etc.)
For most users, this is the easiest solution. If your host provides a control panel like cPanel:
- Log in to your hosting control panel.
- Find the PHP configuration section, often called "Select PHP Version" or "PHP Extensions."
- Locate the module mentioned in the warning (e.g.,
imagick,zip). - Ensure the checkbox next to it is ticked to enable it.
- Save your changes.
Important: If you recently changed your PHP version, you must complete this step again for the new version. Enabling an extension for PHP 7.2 does not enable it for PHP 7.3 or 8.0.
3. Contact Your Web Host
If you do not have access to your server's control panel or are unsure how to proceed, your best course of action is to contact your web hosting provider's support team. You can send them the exact warning message from the Health Check page, and they can enable the requested module on the server for you.
4. Understand the Module's Importance
Not all warnings are created equal. It's helpful to know what a module does:
- Imagick (Optional): An image processing library. WordPress can function perfectly without it by using the GD library instead. You can often safely ignore a missing
imagickwarning unless you use a theme or plugin that specifically requires it. - Zip (Recommended): Allows WordPress to handle compressed
.zipfiles, which is crucial for updating themes, plugins, and WordPress itself. It is highly recommended to have this enabled. - Mcrypt (Deprecated): This module is deprecated and removed in modern PHP versions. If you see a warning for
mcrypt, you are likely running an old version of the Health Check plugin. Updating the plugin should resolve this false warning.
When the Warning Might Be Incorrect
In some cases, the Health Check plugin might report a module as missing even when it is enabled. This can happen if the plugin cannot read the local PHP configuration. If you are certain a module is enabled (perhaps by checking with your host), but the warning persists, it is likely a false positive that a future plugin update may resolve. You can safely ignore it if your site is functioning normally.
By following these steps, you should be able to either resolve the warnings or understand which ones you can safely disregard, helping you maintain a healthy and well-performing WordPress site.
Related Support Threads Support
-
missing param in the sprintf for utf8mb4https://wordpress.org/support/topic/missing-param-in-the-sprintf-for-utf8mb4/
-
7.2 or 7.1https://wordpress.org/support/topic/7-2-or-7-1/
-
Site Health Info – Wrong Datahttps://wordpress.org/support/topic/site-health-info-wrong-data/
-
The optional module, imagick, is not installed, or has been disabled.https://wordpress.org/support/topic/the-optional-module-imagick-is-not-installed-or-has-been-disabled/
-
The optional module, imagick, is not installed, or has been disabled.https://wordpress.org/support/topic/the-optional-module-imagick-is-not-installed-or-has-been-disabled-2/
-
mcrypt is not supported in PHP 7.2 and uphttps://wordpress.org/support/topic/mcrypt-is-not-supported-in-php-7-2-and-up/
-
“imagick module not installed, or disabled” messagehttps://wordpress.org/support/topic/imagick-module-not-installed-or-disabled-message/
-
Imagick PHP 8https://wordpress.org/support/topic/imagick-php-8/
-
Error in warning about MySQLhttps://wordpress.org/support/topic/error-in-warning-about-mysql/
-
modules are enabled but HC still reports them as missing or disabledhttps://wordpress.org/support/topic/modules-are-enabled-but-hc-still-reports-them-as-missing-or-disabled/
-
Health check gives alerts on missing php modules only available in php 7.1https://wordpress.org/support/topic/helth-check-gives-alerts-on-mising-php-modules-only-available-in-php-7-1/
-
Zip Not Installedhttps://wordpress.org/support/topic/zip-not-installed/
-
Typo in Health Check report for PHP Extensionshttps://wordpress.org/support/topic/typo-in-health-check-report-for-php-extensions/
-
fileinfo and imagick not installed, using ea-php73https://wordpress.org/support/topic/fileinfo-and-imagick-not-installed-using-ea-php73/
-
Not having imagick should not be classed as a critical errorhttps://wordpress.org/support/topic/not-having-imagick-should-not-be-classed-as-a-critical-error/
-
Mysql version confused with PHP?https://wordpress.org/support/topic/mysql-version-confused-with-php/
-
Version 1.2.4 incorrect error messagehttps://wordpress.org/support/topic/version-1-2-4-incorrect-error-message/
-
Receiving Errors: Extension ‘mysql_’https://wordpress.org/support/topic/receiving-errors-extension-mysql_/
-
More PHP Extensionshttps://wordpress.org/support/topic/more-php-extensions/
-
Tiny typo in PHP module messagehttps://wordpress.org/support/topic/tiny-typo-in-php-module-message/
-
possible typohttps://wordpress.org/support/topic/possible-typo/