Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

An upgrade test environment

Set up a place to test a theme against new Exponential and PHP versions - a separate installation installed with Composer, demo content, the theme as a Git checkout, and a way to reset it - never a live site.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/lifecycle/upgrade-test-environment.md

On this page

An upgrade test environment

This page is for designers who maintain themes. You need an installation where breaking things is fine.

What it consists of

PartHow
An Exponential installationInstalled with Composer, on a server or your computer; SQLite is the default database and needs no server
Your themeAs a Git checkout, so you can switch branches (Develop with Git)
Demo contentThe theme's demo package or seed data (Demo content)
A second PHP versionTo test the oldest and newest PHP you claim
A resetA copy of the database and var/ you can restore, or a scripted reinstall

Step by step

  1. Install Exponential into a new directory following Getting started.

  2. Let Composer clone your theme as a source checkout:

    composer config 'preferred-install.yourvendor/*' source
    composer require yourvendor/mytheme:dev-main
  3. Activate the theme and choose it for a siteaccess (Activating a theme).

  4. Import the demo content.

  5. Save a reset point: copy the database file (SQLite) or dump the database, and var/storage.

  6. Write the steps into your theme's doc/testing.md, so the next test starts in minutes.

Rules

  • Never test on a live site or with a copy of real customer data.
  • Send mail of the test installation to files, never to real addresses.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x