Eli's PHP Compatibility Scanner
| 开发者 | eliehanna |
|---|---|
| 更新时间 | 2026年10月7日 10:24 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
exec() function is enabled. Many managed hosts (WP Engine, Kinsta, SiteGround and others) turn exec() off, and the free scanner needs it.
If your site is on one of those hosts, PHP Compatibility Scanner Pro runs the scan on a remote service instead, so it does not need exec() and the heavy work happens off your live server. Pro is a separate plugin, available from coffeewp.dev.
How it works
PHP_CodeSniffer turns your code into PHP tokens instead of searching it as text. A function name inside a comment or a string is not reported, and each finding names the PHP version that deprecated or removed what your code uses.
How to Use:
- Open PHP Compatibility Scanner in the WordPress admin menu
- Review the System Check section to ensure your environment is compatible
- Select the plugins and/or themes you want to scan by checking their boxes
- Configure your scan options:
- Target PHP Version: Choose the PHP version you want to test against (7.4 - 8.4)
- Batch Size: Select how many files to process at once (default: 50 files)
- Skip Vendor Directory: Keep checked to skip third-party dependencies
- Click Start Scan to begin the compatibility check
- View results in real-time as each plugin/theme is scanned
- Review any errors (❌) or warnings (⚠️) found in your code
- Click on any target to expand and see detailed compatibility issues
安装:
- Development Environment: LocalWP, XAMPP, MAMP, or self-hosted server
- PHP 7.4+: Required for plugin operation
- WordPress 5.8+: Minimum WordPress version
- Download/Install the plugin to your
wp-content/plugins/directory - Activate Plugin in WordPress Admin → Plugins
- Open the scanner via PHP Compatibility Scanner in the WordPress admin menu
屏幕截图:
常见问题:
What is this plugin for?
This plugin helps WordPress developers check if their custom code (plugins and themes) will work with different PHP versions. It's especially useful when planning to upgrade PHP on production servers or when developing for clients with specific PHP version requirements.
Why won't it work on my hosting provider?
Most managed hosting providers (WP Engine, Kinsta, SiteGround, etc.) disable the exec() function for security reasons. This plugin needs to run PHP commands to analyze your code, which requires this function to be enabled.
Can I scan a site on managed hosting?
Not with this plugin: it needs exec() and access to a PHP binary, and managed hosts disable both. PHP Compatibility Scanner Pro sends the plugin or theme to a remote scan service instead, so the scan never runs on your server. It is a separate plugin, available from coffeewp.dev.
What PHP versions can I test against?
The plugin can test your code against PHP versions 7.4 through 8.4, helping you identify compatibility issues before upgrading.
How accurate are the results?
The scan runs PHP_CodeSniffer with the PHPCompatibility standard, a ruleset maintained specifically to track what changed in each PHP release. PHP_CodeSniffer parses your code into PHP tokens instead of searching it for text patterns, so every match is judged in context. A function name that appears inside a comment or a string is not reported, and a call is only flagged against the PHP versions that actually changed it. Scanners built on pattern matching cannot make that distinction, which is where both false alarms and missed issues come from.
Which PHP version should I check against?
The one your host will move you to. PHP 8.2 gets security fixes until 31 December 2026, PHP 8.3 until 31 December 2027 and PHP 8.4 until 31 December 2028. Many hosts upgrade older sites automatically around those dates, so check before they do.
Can I scan multiple plugins at once?
Yes. You can select multiple plugins and themes to scan simultaneously. The plugin processes them in batches to manage memory usage efficiently.
What if the scan takes too long?
You can stop a long-running scan at any time. Lowering the batch size also helps on servers with tight memory or execution limits.
Are my files modified during scanning?
No, your files are never modified. The plugin only reads your code to analyze it. Any temporary files created during scanning are automatically cleaned up.
更新日志:
- Fix: no longer causes a fatal error when another CoffeeWP plugin that bundles the same promotional sidebar library is active. Whichever plugin loaded second could stop the site.
- Improved: the sidebar library now loads only on the scanner's own screens, instead of on every admin page.
- Links to coffeewp.dev now carry a short fixed tag identifying which link was clicked. No site address, email or other information about you is added.
- New: the scanner has its own top-level admin menu, with Scan and Settings screens instead of a buried submenu.
- New: Scan Options shows a loading skeleton while the system check runs, so the screen no longer looks empty on slow hosts.
- New: when the system check fails, the screen explains what failed and what to try, instead of only reporting that scanning is unavailable.
- Improved: reworked scan page: clearer mode buttons, a results modal, and corrected summary counts.
- Improved: support links now point to the right place for free users.
- Fix: no longer fatals when another edition of the scanner is already active.
- Fix: hardened handling of admin AJAX request input.
- Fix: "Unable to run phpcs --version with detected PHP binary" on LocalWP/macOS. PHP_BINARY pointed to php-fpm, a server SAPI that cannot run CLI scripts; the scanner now resolves the CLI php binary from the same PHP install.
- Tested up to WordPress 7.0. Older releases are listed in changelog.txt, included with the plugin.