Skip to content

Revise PHP upgrade instructions in README #703

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

Open
owaincuvelier wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Revise PHP upgrade instructions in README #703

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6e7c893
Revise PHP upgrade instructions in README
owaincuvelier Feb 24, 2026
50ba0a7
Apply suggestions from code review
owaincuvelier Feb 24, 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
29 changes: 17 additions & 12 deletions other-docs/guides/updating-php/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,24 +106,29 @@ page.
You can add these to the ignored directories in the command when checking if desired;
e.g. `--ignore=vendor/aws,vendor/guzzlehttp,...`.

## Requesting A Cloud Environment Update
## Upgrading the Altis Cloud Environment

Once you are confident that your application is compatible with the version of PHP to upgrade to you should do the
following for each environment:
When you're happy your custom application code, themes, plugins, and dependencies are fully compatible with the target PHP version, *it is recommended to test the upgrade in a non-production environment first.*

1. Create a support ticket for the target environment with the type "Task", titled "Upgrade to PHP 8.3", replacing "8.3"
with the target version if necessary ( noting that the updated PHP version will not be deployed automatically until
the next application deployment ).
2. Wait for the Altis team to confirm the environment has been updated.
3. Deploy the updated application code.
Steps to change the PHP version:
Comment on lines +109 to +113
Copy link

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section changes the process from “requesting” a PHP upgrade (support ticket / Altis team action) to a self-serve Dashboard setting, but other docs still describe PHP upgrades as an infrastructure change performed by support (e.g. other-docs/guides/getting-help-with-altis/README.md:55-57). Please reconcile the documentation (update the other guide and/or add a note here about when a support request is still required) so readers don’t get conflicting instructions.

Copilot uses AI. Check for mistakes.

**Note:** We recommend starting with your non production environments first.
1. Log in to the Altis Dashboard:
https://dashboard.altis-dxp.com/
Comment on lines +115 to +116
Copy link

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For consistency with the rest of the docs, consider formatting the Dashboard URL as a Markdown link (or autolink) instead of a bare URL on its own line (e.g. [Altis Dashboard](https://dashboard.altis-dxp.com/) is used elsewhere). This also avoids any renderer-specific issues where plain URLs might not be linkified.

Copilot uses AI. Check for mistakes.

See the [Getting Help With Altis guide](../getting-help-with-altis.md) for more information on creating support tickets.
2. Select the environment where you want to update the PHP version (e.g., Development, Staging, or Production).

The Altis team will follow up with you on the ticket once the environment has been updated.
3. Navigate to:
Settings → Environment

Once your environment has been upgraded, the PHP upgrade will take effect upon the next application deployment.
4. In the Environment panel, locate the PHP version selector and choose the desired supported PHP version from the dropdown. Click the `Update` button to save the change.

5. Trigger a deployment - The PHP version change will not take effect until a new deployment is performed. Go to the Release tab in the Altis Dashboard and initiate a new deployment (or redeploy the latest release). Once the deployment finishes successfully, the environment will be running the selected PHP version.

Post-upgrade recommendations:
- Verify the site loads correctly.
- Check application logs for PHP warnings or errors.
- Test critical functionality and background jobs.
- Monitor performance and error reporting for a short period after deployment.

## Re-Enable Composer's Platform Check

Expand Down