ddev-typo3-multi-version-extension

What is ddev-typo3-multi-version-extension

ddev-typo3-multi-version-extension is a DDEV add-on that provides a multi-version TYPO3 environment. With this feature, it is possible to develop and test your extension with different TYPO3 versions at the same time.

Support

• TYPO3 11.5
• TYPO3 12.4
• TYPO3 13.4

Requirements

• apache-fpm as webserver type

Installation

Install the add-on with the following command:

ddev add-on get ddev/ddev-typo3-multi-version-extension && ddev restart

After the installation, you can use the following command to open the intro page:

ddev launch

To install TYPO3 instances, use the following command:

ddev install all
# or for a specific version
ddev install 11

Configuration

By default, a blank TYPO3 instance will be installed for each version. They are only two extensions installed:

• your main extension from the project root (symlinked)
• a demo sitepackage extension in from the Tests/.typo3-setup/packages directory

Use this sitepackage to test the features of your main extension. You can adjust it to your needs in Tests/.typo3-setup/packages/sitepackage/.

If you need more extensions for your setup, you can place them in the Tests/.typo3-setup/packages directory or adjust the ddev install command. Within the e.g. the .install-12 file, you can adjust the composer require command to fit your needs.

If you need additional data for the automatic installation process, place a TYPO3 export file in the Tests/.typo3-setup/data directory.

Usage

You can launch a TYPO3 instance in your browser with the following command:

ddev launch 11
ddev launch 12
ddev launch 13

If you want to open the TYPO3 backend directly, use the following command:

ddev launch 13 /typo3

If you want to execute a console command in a specific TYPO3 instance, use the following command:

ddev 11 composer update
ddev 12 typo3 cache:flush
ddev 13 ls -la

You can also run a command in all TYPO3 instances at once:

ddev all typo3 cache:flush

Background

The TYPO3 instances are located in the .Build/ directory. The main extension is symlinked from the root directory to the .Build/ directory.

.
└── .Build/
    ├── 11/
    │   ├── config/
    │   ├── packages/
    │   │   ├── sitepackage/
    │   │   └── your-ext/
    │   ├── public/
    │   ├── var/
    │   ├── vendor/
    │   ├── composer.json
    │   └── composer.lock
    └── ...

Contributed and maintained by @jackd248