Add wp core check-update-db command

[Copilot]

• Add check-update-db method to Core_Command class
• Implement logic to check if database update is needed (compare wp_db_version with current db_version)
• Add support for --network flag for multisite installations
• Add appropriate WP-CLI output messages
• Update composer.json to register the new command
• Create Behat feature tests for the new command
• Address PR feedback:
  • Revert README.md (auto-generated file)
  • Fix composer.json semver version range
  • Fix code formatting alignment
• Request code review and security scan (both passed with no issues)

Summary

Successfully implemented wp core check-update-db command that checks whether a WordPress database update is needed. The command:

• Returns exit code 1 when update is needed, 0 when database is up to date
• Compares wp_db_version with current db_version option
• Supports --network flag to check all sites in a multisite installation
• Follows the same patterns as existing wp core check-update command
• Includes comprehensive Behat tests for single site and multisite scenarios

All PR feedback has been addressed.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Improve DB update commands</issue_title>
<issue_description>We currently have a command wp core update-db that sometimes needs to be run after an update of Core.

It would be great to have a mechanism to check whether an update is actually needed.

Also, both commands might make more sense as wp db ... commands, instead of wp core ... commands.

Suggestion:

wp db check-update     Checks for the need for WordPress database updates.
wp db update           Runs the WordPress database update procedure.

Related issue: wp-cli/wp-cli#5085

cc @swissspidy </issue_description>

<agent_instructions>The new command should be wp core check-update-db, to align with wp core check-update</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Improve DB update commands #293

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

Pull request overview

This PR implements a new wp core check-update-db command that checks whether a WordPress database update is needed without actually performing the update. The command compares the current database version with the version required by WordPress core and returns appropriate exit codes (1 if update needed, 0 if up to date).

Changes:

• Added check_update_db method to Core_Command class that checks database version compatibility
• Implemented support for --network flag to check all sites in a multisite installation
• Registered the new command in composer.json
• Created comprehensive Behat tests covering single site, multisite, and error scenarios

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
src/Core_Command.php	Implements the new check_update_db method that compares database versions and handles both single site and multisite scenarios
features/core-check-update-db.feature	Comprehensive test coverage including single site checks, multisite checks, and error handling for non-multisite installations
composer.json	Registers the new core check-update-db command in the package configuration

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.