To attend in developing PHPUnit tests for the given examples during the workshop you are kindly asked to install the actual repository to your local development environment. Any other setup or environment than PhpStorm, DDEV and macOS is highly welcome, but please be advised that support can only be given for macOS and the following requirements.
Please ensure that your machine meets the following requirements:
- A Docker provider
- Please install one of the following Docker provider. The (free version) of Orbstack is recommended.
- DDEV
- This repository and the installation of TYPO3 relies on the Docker-based PHP development environment DDEV. Though the repository can also be used by configuring Docker manually, it is strongly recommended to use DDEV, to leverage all functionality PhpStorm or Visual Code provides. During the workshop you will be guided through the configuration of DDEV within PhpStorm.
- DDEV plugin
- There is a DDEV plugin for PhpStorm as well as for Visual Studio Code available, which is strongly advised to be installed.
Please follow these steps to install the repository, respectively TYPO3, to your local machine:
- Clone the repository to a folder your Docker provider has access to:
git clone [email protected]:helmutstrasser/phpunit-workshop-pb.git - Switch into the project root:
cd phpunit-workshop-pb - Start your Docker provider (Docker Desktop/Colima/Orbstack...)
- Start DDEV:
ddev start - Install TYPO3 and all package dependencies:
ddev composer install
For the workshop we neither need a running TYPO3 backend, nor a frontend, nor a functional database. No site configuration is provided or necessary. During the workshop we will never open the project in a browser.
Though, just in case you want to check whether the installation succeeded, you can fire up the backend by running through the setup wizard:
- Add a
FIRST_INSTALLfile to thepublicfolder - Open the project in a browser: https://phpunit-workshop.ddev.site/typo3/install.php
- Run through the steps and add an administrative user
- Open the backend after finishing the setup wizard
Please be advised that any code located in the theme extension
(packages/theme) is NOT supposed to make any sense being called from the
website. All classes are standalone examples we will develop tests for during
this workshop.
I will do everything in my power to support you at solving problems with your installation. To save precious time during the workshop I warmly welcome you to make contact with me beforehand via the following options (in English or German):
