TYPO3 composer: Installing extensions
Installing extensions in composer based TYPO3 installations is not possible via the TYPO3 backend.
Trying so will yield the following error message:
Composer mode
The system is set to composer mode. Please notice that it is not possible to add an extension with the Extension Manager. You have to use composer to add further extensions to your system.
This tutorial assumes you're developing locally with docker/composer.
In our example we're adding the extension "powermail".
Find out the extension's composer path
You can usually get the composer path from the extension repository. Just search for the extension and look for "composer support".
For powermail, head to
https://extensions.typo3.org/extension/powermail
The composer path is "composer req in2code/powermail".
Find out which version of the extension supports your TYPO3 version
Make sure that the version of the extension you're about to install is compatible for your TYPO3. If you want to install powermail in TYPO3 9.5 you can't install the newest version but need to install Version 7.4.
Add the extension to composer requirements
Now add the extension to composer requirements:
docker-compose run composer --ignore-platform-reqs require in2code/powermail ^7.4
To explain:
- --ignore-platform-reqs
ignores platform requirements - so if you don't have gd installed in the composer image installation does not fail - in2code/powermail
this is the path where the composer version of the extension is maintained - ^7.4
specifies the version we want to install (7.4.x)
Update you composer installation
docker-compose run composer update
After this step the extension is installed and you can activate it.
Deployment
If your docker/composer setup is configured for automatic deployment you don't need to do anything. Pushing to the respective branches builds the TYPO3 as per the composer requirements and pushes the build to staging / production environment.