Skip to content

Introduce --version=beta argument for updating to latest WordPress beta/RC #315

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Copilot wants to merge 2 commits into from
Closed

Introduce --version=beta argument for updating to latest WordPress beta/RC #315

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6c6b46a
Initial plan
Copilot Mar 11, 2026
4ef52d8
Add --version=beta support for wp core update and wp core download
Copilot Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions features/core-download.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -484,3 +484,24 @@ Feature: Download WordPress
Success:
"""

@require-php-7.4
Scenario: Installing beta version using --version=beta
Given an empty directory
And an empty cache

When I try `wp core download --version=beta`
Then the wp-settings.php file should exist
And STDOUT should contain:
"""
Downloading WordPress
"""
And STDOUT should contain:
"""
(en_US)...
"""
And STDOUT should contain:
"""
Success: WordPress downloaded.
"""
And the return code should be 0

19 changes: 19 additions & 0 deletions features/core-update.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -538,3 +538,22 @@ Feature: Update WordPress core
"""
Success:
"""

@require-php-7.4
Scenario: Use `--version=beta` to update to the latest beta version
Given a WP install

# Using `try` since checksums might not be available for beta/RC.
When I try `wp core update --version=beta --force`
Then STDOUT should contain:
"""
Updating to version
"""
And STDOUT should contain:
"""
(en_US)...
"""
And STDOUT should contain:
"""
Success: WordPress updated successfully.
"""
128 changes: 105 additions & 23 deletions src/Core_Command.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ public function check_update( $args, $assoc_args ) {
* : Select which language you want to download.
*
* [--version=<version>]
* : Select which version you want to download. Accepts a version number, 'latest' or 'nightly'.
* : Select which version you want to download. Accepts a version number, 'latest', 'nightly', or 'beta'.
*
* [--skip-content]
* : Download WP without the default themes and plugins.
Expand Down Expand Up @@ -226,12 +226,21 @@ public function download( $args, $assoc_args ) {
$version = 'nightly';
}

// Nightly builds and skip content are only available in .zip format.
$extension = ( ( 'nightly' === $version ) || $skip_content )
? 'zip'
: 'tar.gz';
if ( 'beta' === strtolower( $assoc_args['version'] ) ) {
$offer = $this->get_beta_download_offer( $locale, $insecure );
$version = $offer['current'];
$download_url = $offer['download'];
if ( ! $skip_content ) {
$download_url = str_replace( '.zip', '.tar.gz', $download_url );
}
} else {
// Nightly builds and skip content are only available in .zip format.
$extension = ( ( 'nightly' === $version ) || $skip_content )
? 'zip'
: 'tar.gz';

$download_url = $this->get_download_url( $version, $locale, $extension );
$download_url = $this->get_download_url( $version, $locale, $extension );
}
} else {
try {
$offer = ( new WpOrgApi( [ 'insecure' => $insecure ] ) )
Expand Down Expand Up @@ -1095,7 +1104,7 @@ private static function get_core_checksums( $version, $locale, $insecure ) {
* : Only perform updates for minor releases (e.g. update from WP 4.3 to 4.3.3 instead of 4.4.2).
*
* [--version=<version>]
* : Update to a specific version, instead of to the latest version. Alternatively accepts 'nightly'.
* : Update to a specific version, instead of to the latest version. Alternatively accepts 'nightly' or 'beta'.
*
* [--force]
* : Update even when installed WP version is greater than the requested version.
Expand Down Expand Up @@ -1229,6 +1238,7 @@ public function update( $args, $assoc_args ) {
}
} elseif ( Utils\wp_version_compare( $assoc_args['version'], '<' )
|| 'nightly' === $assoc_args['version']
|| 'beta' === $assoc_args['version']
|| Utils\get_flag_value( $assoc_args, 'force' )
|| ! empty( $assoc_args['locale'] ) ) {

Expand All @@ -1240,22 +1250,45 @@ public function update( $args, $assoc_args ) {
*/
$locale = Utils\get_flag_value( $assoc_args, 'locale', get_locale() );

$new_package = $this->get_download_url( $version, $locale );

$update = (object) [
'response' => 'upgrade',
'current' => $assoc_args['version'],
'download' => $new_package,
'packages' => (object) [
'partial' => null,
'new_bundled' => null,
'no_content' => null,
'full' => $new_package,
],
'version' => $version,
'locale' => $locale,
];

if ( 'beta' === $version ) {
$insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false );
$offer = $this->get_beta_download_offer( $locale, $insecure );
$version = $offer['current'];

/** @var array{full?: string, no_content?: string|null, new_bundled?: string|null, partial?: string|null} $packages */
$packages = isset( $offer['packages'] ) && is_array( $offer['packages'] ) ? $offer['packages'] : [];
$new_package = ! empty( $packages['no_content'] ) ? $packages['no_content'] : $offer['download'];

$update = (object) [
'response' => 'upgrade',
'current' => $version,
'download' => $new_package,
'packages' => (object) [
'partial' => $packages['partial'] ?? null,
'new_bundled' => $packages['new_bundled'] ?? null,
'no_content' => $packages['no_content'] ?? null,
'full' => $packages['full'] ?? $offer['download'],
],
'version' => $version,
'locale' => $offer['locale'] ?? $locale,
];
} else {
$new_package = $this->get_download_url( $version, $locale );

$update = (object) [
'response' => 'upgrade',
'current' => $assoc_args['version'],
'download' => $new_package,
'packages' => (object) [
'partial' => null,
'new_bundled' => null,
'no_content' => null,
'full' => $new_package,
],
'version' => $version,
'locale' => $locale,
];
}
}

if ( ! empty( $update )
Expand Down Expand Up @@ -1605,6 +1638,55 @@ private function get_download_url( $version, $locale = 'en_US', $file_type = 'zi
return "https://{$locale_subdomain}wordpress.org/wordpress-{$version}{$locale_suffix}.{$file_type}";
}

/**
* Gets the download offer for the latest WordPress beta or RC version.
*
* Queries the WordPress.org version-check API with `channel=beta` to retrieve
* the current beta or release candidate download offer.
*
* @param string $locale Locale to request. Defaults to 'en_US'.
* @param bool $insecure Whether to retry without certificate validation on TLS handshake failure.
* @return array{current: string, download: string, locale: string, packages: array{full: string, no_content: string|null, new_bundled: string|null, partial: string|null}} Associative array with download offer data.
*/
private function get_beta_download_offer( $locale = 'en_US', $insecure = false ) {
$url = 'https://api.wordpress.org/core/version-check/1.7/?' . http_build_query(
[
'channel' => 'beta',
'locale' => $locale,
],
'',
'&'
);

$options = [
'insecure' => $insecure,
'halt_on_error' => false,
];

/** @var \WpOrg\Requests\Response $response */
$response = Utils\http_request( 'GET', $url, null, [ 'Accept' => 'application/json' ], $options );

if ( ! $response->success || (int) $response->status_code < 200 || (int) $response->status_code >= 300 ) {
WP_CLI::error( "Couldn't fetch response from {$url} (HTTP code {$response->status_code})." );
}

/** @var array{offers: array<int, array{current: string, download: string, locale: string, packages: array{full: string, no_content: string|null, new_bundled: string|null, partial: string|null}}>}|null $data */
$data = json_decode( $response->body, true );

if ( ! is_array( $data ) || empty( $data['offers'] ) ) {
WP_CLI::error( 'No beta version found.' );
}

/** @var array{current: string, download: string, locale: string, packages: array{full: string, no_content: string|null, new_bundled: string|null, partial: string|null}} $offer */
$offer = $data['offers'][0];

if ( ! is_array( $offer ) || empty( $offer['current'] ) || empty( $offer['download'] ) ) {
WP_CLI::error( 'Failed to parse beta version information.' );
}

return $offer;
}

/**
* Returns update information.
*
Expand Down
Loading