Eli's PHP Compatibility Scanner
A PHP compatibility checker for your plugins and themes. See which files and lines will break on PHP 8 before you upgrade.
Solid choice
Eli's PHP Compatibility Scanner is a solid plugin choice in 2026, with a few things worth checking first. It runs on 1K+ sites, is rated 5/5 and was last updated 1 month ago, and scores 72/100 on our health check.
- Momentum — downloads up 85.8% vs the previous 30 days
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & supportDaily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Eli's PHP Compatibility Sca… stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| compatibility | #3 |
| php 8 | #1 |
| php compatibility | #1 |
| php upgrade | #2 |
| php version | #5 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 5 from 3 reviews
About Eli's PHP Compatibility Scanner
From the official readme · v1.2.1Description
Before you upgrade PHP, check your plugins and themes. The scanner reads their code and lists every file and line that will break, or start throwing warnings, on the PHP version you pick (7.4 to 8.4). It checks any plugin or theme installed on the site, including premium and custom ones.
It is a PHP compatibility checker built on PHP_CodeSniffer and the PHPCompatibility ruleset. The plugin ships the current development version of that ruleset instead of its last stable release from 2019, so changes made in PHP 8.1, 8.2, 8.3 and 8.4 are covered.
PHP 8.2 stops receiving security fixes on 31 December 2026. If a site you look after still runs 8.2 or older, now is a good time to check what an upgrade would break.
Where it runs
The free scanner runs on your own setup: LocalWP, XAMPP, MAMP, Docker, or any server where PHP’s 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
Contributing
This plugin is actively developed for WordPress development environments. Contributions are welcome, especially:
- Additional PHP version compatibility rules
- Performance optimizations
- UI/UX improvements
- Hosted environment compatibility solutions
Technical Details
How the scan runs
- Bundled dependencies: PHP_CodeSniffer and the PHPCompatibility ruleset ship with the plugin
- Batch processing: files are scanned in configurable batches (10 to 100) to manage memory usage
- Command execution: PHPCS is invoked through PHP’s
exec()function - Server-side state: file lists are stored in WordPress options to keep AJAX requests small
- Progressive UI: batch results appear in real time, with stop and start controls
Dependencies
- PHP_CodeSniffer: ^3.13 (static analysis engine)
- PHPCompatibility: dev-develop (compatibility ruleset)
License
GPLv2 or later – same as WordPress core.
Installation
Prerequisites
- Development Environment: LocalWP, XAMPP, MAMP, or self-hosted server
- PHP 7.4+: Required for plugin operation
- WordPress 5.8+: Minimum WordPress version
Setup Instructions
- 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
Note: All required dependencies (PHP_CodeSniffer and PHPCompatibility) are included with the plugin, no additional setup required.
Changelog
Fixes a fatal error when another CoffeeWP plugin bundling the same sidebar library is active.
1.2.1
- 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.
1.2.0
- 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.
1.1.3
- 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.
Screenshots
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Eli's PHP Compatibility Scann… alternatives
All compatibility plugins →FAQ
Eli's PHP Compatibility Scanner: quick answers
Straight answers, pulled from live WordPress.org data.
Source: WordPress.org
Is Eli's PHP Compatibility Scanner free?
Yes. Eli's PHP Compatibility Scanner is free to download and use from the official WordPress.org plugin directory.
Is Eli's PHP Compatibility Scanner safe to use in 2026?
Eli's PHP Compatibility Scanner is a solid plugin choice in 2026, with a few things worth checking first. It runs on 1K+ sites, is rated 5/5 and was last updated 1 month ago, and scores 72/100 on our health check.
How many websites use Eli's PHP Compatibility Scanner?
Eli's PHP Compatibility Scanner is active on 1K+ WordPress websites and has been downloaded 7,665 times since it launched in October 2025. It was downloaded 2,614 times in the last 30 days.
Does Eli's PHP Compatibility Scanner work with WordPress 7.1?
Eli's PHP Compatibility Scanner is officially tested up to WordPress 7.0.9, while the latest release is 7.1.5. It may still work, but try it on a staging site first.
What PHP version does Eli's PHP Compatibility Scanner need?
Eli's PHP Compatibility Scanner requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Eli's PHP Compatibility Scanner last updated?
The latest version, 1.2.1, was released on October 7, 2026 (1 month ago).
Who makes Eli's PHP Compatibility Scanner?
Eli's PHP Compatibility Scanner is developed and maintained by Eli Hanna.
What are the best alternatives to Eli's PHP Compatibility Scanner?
The most popular alternatives to Eli's PHP Compatibility Scanner are Plugin Compatibility Checker (10K+ installs), Better Plugin Compatibility… (4K+ installs) and BrightLeaf Digital PHP Comp… (500+ installs).
Powered by PageForge
One template and a spreadsheet. A real page for every search.
PageForge turns each row of a CSV into a WordPress page with its own title, URL, SEO fields and schema, built on the layout you already designed. Free on WordPress.org.
- CSV and XLSX, plus Google Sheets on Professional and Enterprise
- Its own title, URL, SEO fields and schema for every page
- Works with the block editor, Elementor, Divi and Avada
- Free on WordPress.org, no credit card




