Make sure your plugins and themes are compatible with newer PHP versions.
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 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 that can cause false positives. We are continuously working to ensure the checker provides the most accurate results possible.
This plugin relies on Tide 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 for more information.
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 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 [email protected].
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.
Yes, this plugin can be used any ANY WordPress website on ANY host.
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.
We maintain a whitelist of plugins that cause false positives. If your plugin shows up as incompatible but you think that is wrong, please open a GitHub issue on the project, or email [email protected] 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).
Yes! While you cannot use this WordPress plugin to test your non-WordPress projects, you can use the Open Source PHPCompatibility Library that this plugin is built on.
If your plugin or theme is not available on WordPress.org, then Tide 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.
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 with those details for the Tide team to investigate why that specific plugin or theme version is not appearing in the Tide results.
Yes! WP Engine has a public GitHub repo where you can contribute back to this plugin. Please open an issue on the Plugin GitHub. 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 [email protected].
Fix issue where Buffer was not available to the scans.
phpcompat
WP-CLI command.