Upgrading to v22

If you are migrating from WordPress to Altis, check out the migrating guide first.

To upgrade to Altis v22, edit your composer.json and change the version constraint for altis/altis and any local environment modules to ^22.0.0.

{
	"require": {
		"altis/altis": "^22.0.0"
	},
	"require-dev": {
		"altis/local-server": "^22.0.0"
	},
	"config": {
		"platform": {
			"php": "8.2"
		}
	}
}

Once you have made these changes, run composer update and then run the wp altis migrate command:

# For cloud environments
wp altis migrate

# For local server
composer server cli -- altis migrate

PHP

We now fully support PHP 8.3, allowing you to use it seamlessly in your projects. If you’d like to test your code locally, you can do so with Local Server.

Refer to our PHP Version Guide for up-to-date compatibility, testing and upgrading information.

Headline Features

Altis Local Server Features

New create-alias Command for WP-CLI

Altis Local Server now includes a create-alias command, making it easier to use WP-CLI by generating an alias for the PHP Docker container. This allows users to run commands with a simpler syntax, such as wp @local [command]. This feature is useful for those with WP-CLI installed locally, enabling a more familiar and streamlined workflow with shorter commands and tab completion support.

default-site-url Override Option for WP-CLI

Altis now allows setting a default site URL for WP-CLI commands, ensuring they operate on the correct site within a local environment. This is beneficial when the main site runs on a subpath rather than the root URL.

By configuring this option, developers can avoid unintended operations on the wrong site and improve workflow efficiency.

For more details, refer to the default site URL documentation.

Altis Core improvements

We have incorporated many updates to modules and libraries in Altis to bring in important bug fixes and improvements.

Documentation

Our developer focused documentation has been improved again. As usual, feedback from our customers and partners is always welcome. Please send us any feedback you have.