Title: PHP Compatibility Checker Author: WP Engine Published: June 29, 2016 Last modified: December 14, 2023 --- Search plugins ![](https://ps.w.org/php-compatibility-checker/assets/banner-772x250.png?rev=1446087) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/php-compatibility-checker/assets/icon-256x256.png?rev=1446087) # PHP Compatibility Checker By [WP Engine](https://profiles.wordpress.org/wpengine/) [Download](https://downloads.wordpress.org/plugin/php-compatibility-checker.1.6.3.zip) * [Details](https://wordpress.org/plugins/php-compatibility-checker/#description) * [Reviews](https://wordpress.org/plugins/php-compatibility-checker/#reviews) * [Installation](https://wordpress.org/plugins/php-compatibility-checker/#installation) * [Development](https://wordpress.org/plugins/php-compatibility-checker/#developers) [Support](https://wordpress.org/support/plugin/php-compatibility-checker/) ## Description The WP Engine PHP Compatibility Checker can be used by any WordPress website on any web host to check PHP version compatibility. This plugin will lint theme and plugin code installed on your WordPress site and give you back a report of compatibility issues as reported by [Tide](https://wptide.org) for you to fix. Compatibility issues are categorized into errors and warnings and will list the file and line number of the offending code, as well as the info about why that line of code is incompatible with the chosen version of PHP. The plugin will also suggest updates to themes and plugins, as a new version may offer compatible code. **This plugin does not execute your theme and plugin code, as such this plugin cannot detect runtime compatibility issues.** **Please note that linting code is not perfect. This plugin cannot detect unused code-paths that might be used for backwards compatibility, and thus might show false positives. We maintain a [whitelist of plugins](https://github.com/wpengine/phpcompat/wiki/Results) that can cause false positives. We are continuously working to ensure the checker provides the most accurate results possible.** **This plugin relies on [Tide](https://wptide.org) that constantly scans updated versions of plugins and themes in the background. Your scan results should be near real-time, but if not that just means Tide has not yet scanned your specific plugin or theme version. Please be patient as this may take up to 10 minutes for results to be returned from Tide. Please see the [FAQ](https://wordpress.org/plugins/php-compatibility-checker/faq/) for more information.** #### Update to PHP 7.4 * Use this plugin to check your site for compatibility up to PHP 8.0! * As of [July 2022](https://wordpress.org/about/stats/), 8.52% of WordPress websites run a PHP version older than PHP 7.0. * These versions of PHP have been [deprecated and unsupported](https://secure.php.net/supported-versions.php) for over 2 years. * Only 7.1% of WordPress websites run PHP 8, the current main version of PHP. #### Disclaimer _While this plugin is written to detect as many problems as accurately as possible, 100% reliable detection is very difficult to ensure. It is best practice to run comprehensive tests before you migrate to a new PHP version._ The plugin was created by WP Engine to help the WordPress community increase adoption of modern PHP versions. We [welcome contributors](https://github.com/wpengine/phpcompat) to this plugin, and are excited to see how developers and other WordPress hosts use this plugin. To disclose security issues for this plugin please email WordPress@wpengine.com. ## Screenshots * [[ * Main screen: compatibility checker options * [[ * Compatibility results screen ## Installation _Note: Go to ‘Plugins’ > ‘Add New’ in the WordPress admin and search for “PHP Compatibility Checker” and install it from there._ To manually install: 1. Upload `phpcompat` to the `/wpengine-wp-content/plugins/` directory 2. Activate the plugin through the ‘Plugins’ menu in WordPress You will find the plugin options in the WP Admin `Tools => PHP Compatibility` menu. Once you click `run` it will take a few minutes to conduct the test. Feel free to navigate away from the page and check back later. ## FAQ ### 1. Will this work outside of the WP Engine hosting account? Yes, this plugin can be used any ANY WordPress website on ANY host. ### 2. Are there WP-CLI commands available? As of the 1.6.0 release this plugin no longer includes the `phpcompat` WP-CLI command. If you still require use of that command, then please run version 1.5.2 or older of this plugin as those versions extend WP-CLI and provide commands. ### 3. A plugin I created is listed as not compatible, what should I do? We maintain a [whitelist of plugins](https://github.com/wpengine/phpcompat/wiki/Results) that cause false positives. If your plugin shows up as incompatible but you think that is wrong, please open a [GitHub issue](https://github.com/wpengine/phpcompat/issues/new) on the project, or email wordpress@wpengine.com with info about your plugin and why you know it is compatible (you have automated tests, the failure is on backwards compatibility code paths, etc). ### 4. Can I use this to test non-WordPress PHP Projects? Yes! While you cannot use this WordPress plugin to test your non-WordPress projects, you can use the [Open Source PHPCompatibility Library](https://github.com/wimg/PHPCompatibility) that this plugin is built on. ### 5. Why was my plugin/theme skipped? If your plugin or theme is not available on WordPress.org, then [Tide](https://wptide.org) will not be able to scan or return results of that plugin or theme. ``` If your plugin or theme is available on WordPress.org, but Tide is not immediately returning results than it likely means Tide has not yet audited that plugin or theme and within a few minutes results should be available once Tide completes its audit. ``` ### 6. The scan is stuck, what can I do? As of version 1.6.0 of this plugin, there should no longer be issues of the scan getting stuck as it no longer runs on your WordPress host server. If you are seeing significantly slow or unresponsive results from a plugin or theme that is available on WordPress.org, then please [open an issue](https://github.com/wptide/wptide.org/issues/new/choose) with those details for the Tide team to investigate why that specific plugin or theme version is not appearing in the Tide results. ### 7. I found a bug, or have a suggestion, can I contribute back? Yes! WP Engine has a public GitHub repo where you can contribute back to this plugin. Please open an issue on the [Plugin GitHub](https://github.com/wpengine/phpcompat). We actively develop this plugin, and are always happy to receive pull requests. ``` The plugin was created by WP Engine to help the WordPress community increase adoption of modern PHP versions. We welcome contributors to this plugin, and are excited to see how developers and other WordPress hosts use this plugin. To disclose security issues for this plugin please email WordPress@wpengine.com. ``` ## Reviews ![](https://secure.gravatar.com/avatar/53b08e46728f7698e9fa9b7fe62b3df53c2ab9855d99af82b9ef2bb949f1a28f? s=60&d=retro&r=g) ### 󠀁[Con WP5.1 y PHP7.4, falla](https://wordpress.org/support/topic/con-wp5-1-y-php7-4-falla/)󠁿 [manare](https://profiles.wordpress.org/manare/) January 21, 2026 Ell plugin no muestra versiones ni escanea ![](https://secure.gravatar.com/avatar/12228e1a85602993e2ec76bca84d0407198ee8f320e25d271f1bbe614dfaf72b? s=60&d=retro&r=g) ### 󠀁[Why is this recommended by WordPress?](https://wordpress.org/support/topic/why-is-this-recommended-by-wordpress/)󠁿 [cweb](https://profiles.wordpress.org/calebweb/) September 29, 2025 Over the years, I have tried to be careful to not install programs that are not kept up to date. Yet, Wordpress suggest that we install this outdated app that has not been updated for over 2 years. Many have reported errors. All just to test for the push that WP has for us to upgrade the version of PHP we are using. This doesn’t make sense!I had tried to put a link to where WP suggest this, but strangely the forums won’t even let me put a link to their own website. ![](https://secure.gravatar.com/avatar/a7d849ee7a8ee04533904069509295deaf656ed8e9763d145acb970c5d1883b4? s=60&d=retro&r=g) ### 󠀁[Ironically not compatible with the latest PHP](https://wordpress.org/support/topic/ironically-not-compatible-with-the-latest-php/)󠁿 [aodigitalau](https://profiles.wordpress.org/aodigitalau/) February 6, 2025 Either update the plugin or take it down. ![](https://secure.gravatar.com/avatar/1e5ca569a7679f526f9a15e429da017c66711ce81d9c10da62fec860b42840d8? s=60&d=retro&r=g) ### 󠀁[Rubish, get it offline](https://wordpress.org/support/topic/rubish-get-it-offline/)󠁿 [Okoth1](https://profiles.wordpress.org/okoth1/) October 27, 2023 It hangs like many others say. No replies on the forum. You’re giving people false hope.Just get it offline and focus on your other plugins (which are working very well, btw); you’ll do yourself and many others a favor. ![](https://secure.gravatar.com/avatar/39ed6b59a08d2283b9bfc4d611bdd2a6e5d0e2479fab63a6834b39247feefd26? s=60&d=retro&r=g) ### 󠀁[very buggy and hangs](https://wordpress.org/support/topic/very-buggy-and-hangs/)󠁿 [theozsnowman](https://profiles.wordpress.org/theozsnowman/) May 19, 2023 ran the plugin on quite a few sites and most timeout after a couple of plugins are tested. Lots of false positives and errors. surely there is a better plugin out there? ![](https://secure.gravatar.com/avatar/ea257bb7048ea247773df9108a1f94c2fbd213dbfe45e597defa3bb9ea74ce75? s=60&d=retro&r=g) ### 󠀁[audit requested does not exist](https://wordpress.org/support/topic/gives-404-error-and-hangs/)󠁿 [elffuts](https://profiles.wordpress.org/elffuts/) May 9, 2023 Useless! Gives a 404 error on plugins that ARE PHP 8 compatible. and then hangs. I’ve been waiting 30 minutes for it to unhang, and I finally gave up. It sure would be nice if this thing worked as advertised. Here’s what I got: MaxButtons Pro 9.5.5 Response status: 404 Message: The audit requested does not exist. Am I supposed to know what that means? How do I fix it? Right now it’s completely useless, and it hangs the software — never goes any farther to get to the rest of my plugins. Not a bit of help as is. [ Read all 131 reviews ](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/) ## Contributors & Developers “PHP Compatibility Checker” is open source software. The following people have contributed to this plugin. Contributors * [ WP Engine ](https://profiles.wordpress.org/wpengine/) * [ Jason Stallings ](https://profiles.wordpress.org/octalmage/) * [ Steven Word ](https://profiles.wordpress.org/stevenkword/) * [ Taylor McCaslin ](https://profiles.wordpress.org/taylor4484/) * [ Simon Prosser ](https://profiles.wordpress.org/pross/) * [ Jason ](https://profiles.wordpress.org/jcross/) * [ rfmeier ](https://profiles.wordpress.org/rfmeier/) * [ Max Lyuchin ](https://profiles.wordpress.org/cadic/) * [ Darin Kotter ](https://profiles.wordpress.org/dkotter/) * [ Ankit K Gupta ](https://profiles.wordpress.org/ankit-k-gupta/) * [ Jeffrey Paul ](https://profiles.wordpress.org/jeffpaul/) “PHP Compatibility Checker” has been translated into 25 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/php-compatibility-checker/contributors) for their contributions. [Translate “PHP Compatibility Checker” into your language.](https://translate.wordpress.org/projects/wp-plugins/php-compatibility-checker) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/php-compatibility-checker/), check out the [SVN repository](https://plugins.svn.wordpress.org/php-compatibility-checker/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/php-compatibility-checker/) by [RSS](https://plugins.trac.wordpress.org/log/php-compatibility-checker/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.6.3 Fix issue where Buffer was not available to the scans. #### 1.6.2 * Update packages. #### 1.6.1 * Fix issue on update where old files were included. #### 1.6.0 * Changed from running PHP Compatibility scans on your WordPress server to using scan data from [Tide](https://wptide.org). * Removed `phpcompat` WP-CLI command. * Update dependencies. #### 1.5.2 * Removed PHP 5.2 checks * Fixed PHP 8 issue where plugin cannot cannot be uninstalled. #### 1.5.1 * Added Smart Plugin Manager to whitelisted plugins. #### 1.5.0 * Added support for PHP 7.3 compatibility checks. #### 1.4.8 * Update dependencies. #### 1.4.7 * Better translation support. #### 1.4.6 * Switched to new PHPCompatibilityWP library to help prevent false positives. #### 1.4.5 * Use plugin version number to enqueue scripts and styles. #### 1.4.4 * PHP 5.2 Support & PHP 7.1 and 7.2 Lints. * Updated call to action sidebar depending on platform. #### 1.4.3 * Fixed Composer issue. #### 1.4.1 * Updated PHP_CodeSniffer to fix a security advisory. * Whitelisted a number of plugins. #### 1.4.0 * Updated UX for viewing PHP errors to be more intuitive and require less scrolling. * Added links for non-technical users who need assistance from developers to fix PHP errors or to test their site in PHP 7 enabled hosting environments. #### 1.3.2 * Added a “Clean up” button and uninstall.php. * Added phpcompat_phpversions filter. #### 1.3.1 * Whitelisted a number of plugins. #### 1.3.0 * Updated the PHPCompatibility library to latest version. Should fix many false positives. * Changed language and added help text to Admin UI. #### 1.2.4 * Fixed Composer issue. #### 1.2.3 * Updated the PHPCompatibility library to latest version. * Whitelisted TablePress. #### 1.2.2 * Whitelisted UpdraftPlus and Max Mega Menu. #### 1.2.1 * Updated the PHPCompatibility library to latest version. #### 1.2.0 * Updated the PHPCompatibility library to latest version. * Added support for PHP 5.6 #### 1.1.2 * Fixed issue with WordPress notices breaking the plugin header. * Changed the way we send and parse JSON. * You can now restart an in progress scan. * Updated download.js to v4.2 for better Safari compatibility. #### 1.1.1 * Fixed bug with active job display. * Updated progress bar calculation. #### 1.1.0 * Test results now persist page reloads. * Failed tests will show an overview of the results. * The scan timeout is now configurable using a filter. See the FAQ for more details. #### 1.0.3 * Fixed a bug in the WP-CLI command. * Added a handful of PHP 7 compatible plugins to the whitelist. #### 1.0.2 * Added additional role protections. * Changed the UI colors to better understand output at a glance. * Exclude checking node_modules and tmp directories. * Added support for child theme’s parent theme. #### 1.0.1 * Updated compatibility library with a few bugfixes. * Added skip logic to prevent checker from hanging. #### 1.0.0 * Major update to add PHP 7 checking support. * Improved the UX of the progress bar. * Fixed bug with the way the plugin menu was registered. #### 0.1.0 * Initial version. * PHP 5.5, 5.4, and 5.3 Support. * Basic WP-CLI Commands. ## Meta * Version **1.6.3** * Last updated **2 years ago** * Active installations **200,000+** * WordPress version ** 5.6 or higher ** * Tested up to **6.4.8** * PHP version ** 5.6 or higher ** * Languages * [Arabic](https://ar.wordpress.org/plugins/php-compatibility-checker/), [Bosnian](https://bs.wordpress.org/plugins/php-compatibility-checker/), [Chinese (China)](https://cn.wordpress.org/plugins/php-compatibility-checker/), [Chinese (Taiwan)](https://tw.wordpress.org/plugins/php-compatibility-checker/), [Czech](https://cs.wordpress.org/plugins/php-compatibility-checker/), [Dutch](https://nl.wordpress.org/plugins/php-compatibility-checker/), [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/php-compatibility-checker/), [English (Australia)](https://en-au.wordpress.org/plugins/php-compatibility-checker/), [English (Canada)](https://en-ca.wordpress.org/plugins/php-compatibility-checker/), [English (New Zealand)](https://en-nz.wordpress.org/plugins/php-compatibility-checker/), [English (South Africa)](https://en-za.wordpress.org/plugins/php-compatibility-checker/), [English (UK)](https://en-gb.wordpress.org/plugins/php-compatibility-checker/), [English (US)](https://wordpress.org/plugins/php-compatibility-checker/), [French (France)](https://fr.wordpress.org/plugins/php-compatibility-checker/), [Galician](https://gl.wordpress.org/plugins/php-compatibility-checker/), [German](https://de.wordpress.org/plugins/php-compatibility-checker/), [Japanese](https://ja.wordpress.org/plugins/php-compatibility-checker/), [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/php-compatibility-checker/), [Portuguese (Brazil)](https://br.wordpress.org/plugins/php-compatibility-checker/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/php-compatibility-checker/), [Romanian](https://ro.wordpress.org/plugins/php-compatibility-checker/), [Russian](https://ru.wordpress.org/plugins/php-compatibility-checker/), [Spanish (Argentina)](https://es-ar.wordpress.org/plugins/php-compatibility-checker/), [Spanish (Chile)](https://cl.wordpress.org/plugins/php-compatibility-checker/), [Spanish (Spain)](https://es.wordpress.org/plugins/php-compatibility-checker/), and [Spanish (Venezuela)](https://ve.wordpress.org/plugins/php-compatibility-checker/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/php-compatibility-checker) * Tags * [compat](https://wordpress.org/plugins/tags/compat/)[php](https://wordpress.org/plugins/tags/php/) [version](https://wordpress.org/plugins/tags/version/) * [Advanced View](https://wordpress.org/plugins/php-compatibility-checker/advanced/) ## Ratings 2.7 out of 5 stars. * [ 46 5-star reviews ](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/?filter=5) * [ 6 4-star reviews ](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/?filter=4) * [ 2 3-star reviews ](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/?filter=3) * [ 11 2-star reviews ](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/?filter=2) * [ 66 1-star reviews ](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/php-compatibility-checker/reviews/) ## Contributors * [ WP Engine ](https://profiles.wordpress.org/wpengine/) * [ Jason Stallings ](https://profiles.wordpress.org/octalmage/) * [ Steven Word ](https://profiles.wordpress.org/stevenkword/) * [ Taylor McCaslin ](https://profiles.wordpress.org/taylor4484/) * [ Simon Prosser ](https://profiles.wordpress.org/pross/) * [ Jason ](https://profiles.wordpress.org/jcross/) * [ rfmeier ](https://profiles.wordpress.org/rfmeier/) * [ Max Lyuchin ](https://profiles.wordpress.org/cadic/) * [ Darin Kotter ](https://profiles.wordpress.org/dkotter/) * [ Ankit K Gupta ](https://profiles.wordpress.org/ankit-k-gupta/) * [ Jeffrey Paul ](https://profiles.wordpress.org/jeffpaul/) ## Support Issues resolved in last two months: 0 out of 1 [View support forum](https://wordpress.org/support/plugin/php-compatibility-checker/)