Upgrading page: Add some WP-CLI commands

[javiercasares]

There is great work at #102, but it needs additional information, like how to simplify the process with WP-CLI commands in some cases (focused on updating WordPress core from one version to another and not the latest one).

[ArnasDon]

@javiercasares I can see that everything in #102 ticket is merged and closed. Do we still need any additional changes to it? 🤔

[DustinHyle]

I've updated the page content to include useful WP-CLI commands and put the changes in this Google doc. https://docs.google.com/document/d/1F6OcTEImjFwnTwrBWVsAEtIQyKr4inNkeMLxApuAr5Y/edit?usp=sharing

[sumitrac]

This ticket was contributed a few years back. A few WP CLI commands can save you a significant amount of time compared to using the WordPress admin dashboard.

General Info


wp --info # Check WP-CLI version, PHP version, OS info


🔹 Core Commands

wp core download # Download WordPress core

wp core install # Install WordPress

wp core update # Update WordPress to the latest version

wp core update --version=6.5 # Update to a specific version

wp core check-update # Check for updates

🔹 Database

wp db create # Create a new database

wp db drop # Drop the database

wp db reset # Reset the database

wp db export db.sql # Export database to file

wp db import db.sql # Import database from file

🔹 Plugins

wp plugin list # List all plugins

wp plugin install akismet # Install plugin

wp plugin install akismet --activate # Install and activate

wp plugin activate akismet # Activate a plugin

wp plugin deactivate akismet # Deactivate a plugin

wp plugin update --all # Update all plugins

🔹 Themes

wp theme list # List installed themes

wp theme install twentytwentyone # Install theme

wp theme install twentytwentyone --activate # Install & activate

wp theme activate twentytwentytwo # Activate theme

wp theme delete twentytwenty # Delete theme

🔹 Users

wp user list # List all users

wp user create john john@example.com --role=author # Create a user
wp user delete 2 # Delete user with ID 2

wp user update 2 --display_name="John Doe" # Update user details

🔹 Posts

wp post list # List posts
wp post create --post_title="Hello" --post_status=publish # Create post

wp post delete 45 # Delete post with ID 45

🔹 Options

wp option get siteurl # Get the site URL

wp option update siteurl 'https://example.com/' # Update site URL
wp option delete siteurl # Delete an option

🔹 Search & Replace

wp search-replace 'http://oldsite.com/' 'http://newsite.com/'
(Useful for migrations)

🔹 Media

wp media regenerate # Regenerate thumbnails

wp media import ~/Pictures/*.jpg --featured_image # Import images

🔹 Cache

wp cache flush # Flush cache

🔹 Maintenance

wp maintenance-mode activate # Enable maintenance mode

wp maintenance-mode deactivate # Disable maintenance mode

[kittenkamala]

Thank you both for working on this. I combined the two suggestions and made some small fixes like adding backticks and an s (doc). Please let me know what you think. Do either of you want to open a PR for it?

Upgrading WordPress using WP-CLI
You can upgrade and downgrade WordPress via WP-CLI and even select specific versions!

Here are some useful commands.

Checking Your Current WordPress Version

To see what version of WordPress is currently installed:

wp core version

Checking for Updates

Before updating, check what updates are available:

wp core check-update

Updating WordPress Core

Update to the Latest Version

wp core update

Update to a Specific Version

If you need to install a particular version of WordPress:

wp core update --version=6.4.2

Replace 6.4.2 with your desired version number

Troubleshooting Core Issues

Verify Core File Integrity

If you suspect core files may be corrupted or modified:

wp core verify-checksums

Force Update When Standard Update Fails

If a regular update gets stuck or fails:

wp core update --force

Restore Core Files Without Affecting Content

To re-download WordPress core files while preserving your themes, plugins, and uploads:

wp core download --force --skip-content

Install Specific Version Over Existing Installation

To downgrade or install a specific version while keeping your content:

wp core download --version=6.4.2 --force --skip-content

More WP-CLI Commands

To get a list of available commands:

wp --info

$ wp --info # Check WP-CLI version, PHP version, OS info

🔹 Core Commands

wp core download # Download WordPress core

wp core install # Install WordPress

wp core update # Update WordPress to the latest version

wp core update --version=6.5 # Update to a specific version

wp core check-update # Check for updates

🔹 Database

wp db create # Create a new database

wp db drop # Drop the database

wp db reset # Reset the database

wp db export db.sql # Export database to file

wp db import db.sql # Import database from file

🔹 Plugins

wp plugin list # List all plugins

wp plugin install akismet # Install plugin

wp plugin install akismet --activate # Install and activate

wp plugin activate akismet # Activate a plugin

wp plugin deactivate akismet # Deactivate a plugin

wp plugin update --all # Update all plugins

🔹 Themes

wp theme list # List installed themes

wp theme install twentytwentyone # Install theme

wp theme install twentytwentyone --activate # Install & activate

wp theme activate twentytwentytwo # Activate theme

wp theme delete twentytwenty # Delete theme

🔹 Users

wp user list # List all users

wp user create john john@example.com --role=author # Create a user
wp user delete 2 # Delete user with ID 2

wp user update 2 --display_name="John Doe" # Update user details

🔹 Posts

wp post list # List posts
wp post create --post_title="Hello" --post_status=publish # Create post

wp post delete 45 # Delete post with ID 45

🔹 Options

wp option get siteurl # Get the site URL

wp option update siteurl 'https://example.com/' # Update site URL
wp option delete siteurl # Delete an option

🔹 Search & Replace

wp search-replace 'http://oldsite.com/' 'http://newsite.com/'
(Useful for migrations)

🔹 Media

wp media regenerate # Regenerate thumbnails

wp media import ~/Pictures/*.jpg --featured_image # Import images

🔹 Cache

wp cache flush # Flush cache

🔹 Maintenance

wp maintenance-mode activate # Enable maintenance mode

wp maintenance-mode deactivate # Disable maintenance mode